> ## Documentation Index
> Fetch the complete documentation index at: https://composio-preview.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Files.com

> Files.com is a secure cloud storage and file transfer platform that enables businesses to store, share, and manage files across various cloud services and on-premises systems.

![Files.com logo](https://mintcdn.com/composio-preview/r7CO9m4_UWMVFnU7/images/toolkits/files_com.svg?fit=max\&auto=format\&n=r7CO9m4_UWMVFnU7\&q=85\&s=d4bfebfadf9ce10affe2e86380a61ff8)

* **Category:** file management & storage
* **Auth:** API\_KEY
* **Composio-managed OAuth available?** N/A
* **Tools:** 7
* **Triggers:** 0
* **Slug:** `FILES_COM`
* **Version:** 20261101\_00

## Tools

> [accordion] Delete API Key
>
> **Slug:** `FILES_COM_DELETE_API_KEY`
>
> Tool to delete an API key. Use when you need to revoke an API key after confirming its identifier.
>
> #### Input Parameters
>
> **api\_key\_id** `integer` *required*
>
> The unique identifier of the API key to delete.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete Permission
>
> **Slug:** `FILES_COM_DELETE_PERMISSION`
>
> Removes a permission grant that allows a user or group to access a specific file or folder path on Files.com. A permission ID can be obtained from the LIST\_PERMISSIONS action. Use this tool when you need to revoke access that was previously granted to a user or group for a specific resource. Note: Requires administrative permissions on the Files.com site.
>
> #### Input Parameters
>
> **permission\_id** `integer` *required*
>
> The unique identifier of the permission to delete.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete Share
>
> **Slug:** `FILES_COM_DELETE_SHARE`
>
> Attempts to delete a Files.com share link by ID to revoke access to shared files or folders. A 404 is returned as a not-found result, but does not confirm that the share was deleted.
>
> #### Input Parameters
>
> **share\_id** `integer` *required*
>
> ID of the share link (bundle) to delete. This operation is idempotent - returns success even if the share doesn't exist (404).
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get S3 Key for Upload
>
> **Slug:** `FILES_COM_GET_S3_KEY_FOR_UPLOAD`
>
> Returns the S3 key, MIME type, and name already associated with a supplied file object.
>
> #### Input Parameters
>
> **file** `object` *required*
>
> File object to upload for temporary hosting on Files.com
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Folders
>
> **Slug:** `FILES_COM_LIST_FOLDERS`
>
> Lists Files.com folders for browsing the folder structure, with optional parent and name filters, path sorting, and pagination. When pagination metadata is not provided, totals are calculated from the returned items rather than the full result set.
>
> #### Input Parameters
>
> **page** `integer`
>
> Page number for pagination (1-indexed).
>
> **search** `string`
>
> Partial name filter for folders.
>
> **per\_page** `integer`
>
> Number of folders per page.
>
> **parent\_id** `integer`
>
> ID of the parent folder to list folders for. Defaults to root.
>
> **sort\_by\_path** `string ("asc" | "desc")`
>
> Sort folders by path in ascending or descending order.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Groups
>
> **Slug:** `FILES_COM_LIST_GROUPS`
>
> Lists Files.com groups with pagination, returning available group details such as IDs, names, membership and access permissions. Failed requests can yield an empty list; totals are computed from the returned page, not the full group collection.
>
> #### Input Parameters
>
> **page** `integer`
>
> Page number to retrieve (1-indexed).
>
> **per\_page** `integer`
>
> Number of groups to return per page (max 1000).
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Permissions
>
> **Slug:** `FILES_COM_LIST_PERMISSIONS`
>
> Lists Files.com permission records to inspect access grants, optionally scoped to a path or filtered by user, group, or partner. Supports pagination; when complete pagination metadata is unavailable, totals reflect the returned records rather than the full result set.
>
> #### Input Parameters
>
> **page** `integer`
>
> Page number for pagination (1-based).
>
> **path** `string`
>
> Permission path. Scopes all permissions (including upward) to this path.
>
> **user\_id** `string`
>
> Filter by specific user ID.
>
> **group\_id** `string`
>
> Filter by specific group ID.
>
> **per\_page** `integer`
>
> Number of items per page for pagination.
>
> **partner\_id** `string`
>
> Filter by specific partner ID.
>
> **include\_groups** `boolean`
>
> Include user permissions inherited from groups.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not
