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

# Upload to URL

> Upload files to public CDN URLs, retrieve or delete uploaded file metadata, and publish HTML pages.

![Upload to URL logo](https://mintcdn.com/composio-preview/DMB8UrgJmE7r-ZQ5/images/toolkits/upload_to_url.svg?fit=max\&auto=format\&n=DMB8UrgJmE7r-ZQ5\&q=85\&s=83edb36ac03dead36a65cb7c01900ae6)

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

## Tools

> [accordion] Delete File
>
> **Slug:** `UPLOAD_TO_URL_DELETE_FILE`
>
> Permanently delete a previously uploaded file from storage and its public CDN location.
>
> #### Input Parameters
>
> **file\_id** `string` *required*
>
> The UUID returned in the id field by Upload File. Deletion is permanent.
>
> #### 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 File Metadata
>
> **Slug:** `UPLOAD_TO_URL_GET_FILE_METADATA`
>
> Retrieve current metadata and the public CDN URL for a file previously uploaded by the connected account.
>
> #### Input Parameters
>
> **file\_id** `string` *required*
>
> The UUID returned in the id field by Upload File. This is not the CDN URL or filename.
>
> #### 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 Supported Formats
>
> **Slug:** `UPLOAD_TO_URL_GET_SUPPORTED_FORMATS`
>
> Return the file extensions Upload to URL accepts or blocks, current plan size limits, and advertised upload security checks. Use this before uploading an unfamiliar file type.
>
> #### 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] Publish HTML
>
> **Slug:** `UPLOAD_TO_URL_PUBLISH_HTML`
>
> Publish raw HTML at a public URL under a chosen page path. This irreversible public side effect consumes one monthly credit, and the API provides no way to delete the published page.
>
> #### Input Parameters
>
> **html\_code** `string` *required*
>
> Complete raw HTML content to publish publicly.
>
> **page\_path** `string` *required*
>
> Unique, stable public page path. This is the canonical path field; do not use slug.
>
> **subdomain** `string`
>
> Custom subdomain configured for the connected account. Omit to use the default CDN URL.
>
> **expiry\_days** `string`
>
> Requested retention as an integer-like day string such as '1', or 'never' only when the connected plan supports it. Omit to use the provider default; the response does not confirm expiration.
>
> #### 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] Upload File
>
> **Slug:** `UPLOAD_TO_URL_UPLOAD_FILE`
>
> Upload one file and return its public CDN URL, file ID, expiration, and remaining monthly credits. Each successful call consumes one upload credit.
>
> #### Input Parameters
>
> **file** `object` *required*
>
> The single file to upload.
>
> **source** `string`
>
> Optional caller or source label stored with the upload.
>
> **expiry\_days** `string`
>
> Requested retention as a day count, such as '1', or 'never' when the connected plan supports it. Omit to use the provider default.
>
> #### 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
