# 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.

- **Category:** file management & storage
- **Auth:** API_KEY
- **Composio Managed App Available?** N/A
- **Tools:** 7
- **Triggers:** 0
- **Slug:** `FILES_COM`
- **Version:** 20260227_00

## Tools

### 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `api_key_id` | integer | Yes | The unique identifier of the API key to delete. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `permission_id` | integer | Yes | The unique identifier of the permission to delete. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete Share

**Slug:** `FILES_COM_DELETE_SHARE`

Delete a specified share link (bundle) on Files.com. This operation is idempotent - it succeeds even if the share link has already been deleted or doesn't exist. Use this to revoke public access to shared files/folders when you have the share ID.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `share_id` | integer | Yes | ID of the share link (bundle) to delete. This operation is idempotent - returns success even if the share doesn't exist (404). |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get S3 Key for Upload

**Slug:** `FILES_COM_GET_S3_KEY_FOR_UPLOAD`

Tool to generate a temporary key for file uploads by uploading the file to Files.com. Useful when you need to host a local file temporarily before importing or sharing.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `file` | object | No | File object to upload for temporary hosting on Files.com |
| `file_path` | string | No | Absolute local path to the file to upload (fallback). |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Folders

**Slug:** `FILES_COM_LIST_FOLDERS`

Lists folders in Files.com with optional filtering, sorting, and pagination. Returns a paginated list of folders with metadata. Useful for browsing folder structure, finding specific folders by name, or retrieving folders under a specific parent.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | Page number for pagination (1-indexed). |
| `search` | string | No | Partial name filter for folders. |
| `per_page` | integer | No | Number of folders per page. |
| `parent_id` | integer | No | ID of the parent folder to list folders for. Defaults to root. |
| `sort_by_path` | string ("asc" | "desc") | No | Sort folders by path in ascending or descending order. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Groups

**Slug:** `FILES_COM_LIST_GROUPS`

Retrieves a paginated list of all groups from Files.com. Groups are used to organize users and manage permissions collectively. Use this action to discover available groups, check group membership, or before performing group-based permission operations. Returns group details including IDs, names, member lists, and access permissions (FTP, SFTP, WebDAV, REST API).

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | Page number to retrieve (1-indexed). |
| `per_page` | integer | No | Number of groups to return per page (max 1000). |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Permissions

**Slug:** `FILES_COM_LIST_PERMISSIONS`

Retrieve permissions for a specified path on Files.com. Use when you need to inspect who has access and what level for a given file or folder path.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | Page number for pagination (1-based). |
| `path` | string | No | Permission path. Scopes all permissions (including upward) to this path. |
| `user_id` | string | No | Filter by specific user ID. |
| `group_id` | string | No | Filter by specific group ID. |
| `per_page` | integer | No | Number of items per page for pagination. |
| `partner_id` | string | No | Filter by specific partner ID. |
| `include_groups` | boolean | No | Include user permissions inherited from groups. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |