---
canonical_url: "https://docs.composio.dev/toolkits/drop_to_cdn"
markdown_url: "https://docs.composio.dev/toolkits/drop_to_cdn.md"
product: "platform"
version: null
last_updated: null
---

# Drop to CDN

Upload files and publish HTML pages to public CDN URLs, then list, inspect, and delete hosted files.

- **Category:** file management & storage
- **Auth:** API_KEY
- **Composio-managed OAuth available?** N/A
- **Tools:** 6
- **Triggers:** 0
- **Slug:** `DROP_TO_CDN`
- **Version:** 00000000_00

## Tools

### Permanently Delete File

**Slug:** `DROP_TO_CDN_DELETE_FILE`

Permanently and irreversibly delete a file or hosted page owned by the connected account. This cannot restore monthly upload quota already consumed.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `file_id` | string | Yes | ID of the file or hosted page to permanently delete. Verify this ID before calling because deletion is irreversible. |

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

**Slug:** `DROP_TO_CDN_GET_ACCOUNT_USAGE`

Return the connected account's plan and current upload/storage usage context for deciding whether an upload is appropriate.

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

**Slug:** `DROP_TO_CDN_GET_FILE`

Get metadata and the public CDN URL for one file or hosted page owned by the connected account.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `file_id` | string | Yes | File or hosted-page ID returned by an upload, publish, or list operation. |

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

**Slug:** `DROP_TO_CDN_LIST_FILES`

Return one newest-first page of files and hosted pages owned by the connected account, with a cursor for the next page.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | Maximum files to return in this page (1-100). |
| `cursor` | string | No | Pass the previous response's next_cursor to fetch the next page; omit for the first page. |

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

### Publish Page

**Slug:** `DROP_TO_CDN_PUBLISH_PAGE`

Publish HTML as a publicly hosted page and return its CDN URL. Each successful publish consumes monthly upload quota.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `html` | string | Yes | Complete HTML content to host as a public page. |
| `never_expire` | boolean | No | Set true only on a paid plan that supports non-expiring pages. Omit otherwise; this paid-only behavior was not live-tested. |
| `retention_days` | integer | No | Optional custom retention period in days. Omit to use the plan default. The provider may ignore this on plans without custom retention; custom behavior was not live-tested on the connected Free account. |

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

### Upload File

**Slug:** `DROP_TO_CDN_UPLOAD_FILE`

Upload a file and return its public CDN URL and expiration metadata. Each successful upload consumes monthly upload quota even if the file is later deleted.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `file` | object | Yes | File attachment supplied by Composio. Pass the attachment object unchanged rather than constructing its fields. Executables, scripts, and web pages are blocked; use Publish Page for HTML. File-size limits depend on the connected plan. |
| `never_expire` | boolean | No | Set true only on a paid plan that supports non-expiring uploads. Omit otherwise. |
| `retention_days` | integer | No | Optional custom retention period in days. Omit to use the plan default. The provider may ignore this on plans without custom retention. |

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