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

# Transloadit

Transloadit is a cloud platform for uploading, transforming, and delivering files, images, audio, and video through programmable processing workflows.

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

## Tools

### Cancel Assembly

**Slug:** `TRANSLOADIT_CANCEL_ASSEMBLY`

Cancel a running Assembly and any upload still in progress. Fails if the Assembly reaches another terminal state before cancellation is confirmed.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `assembly_id` | string | Yes | Running Assembly ID to cancel. |

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

### Create Assembly

**Slug:** `TRANSLOADIT_CREATE_ASSEMBLY`

Start a Transloadit file-processing Assembly from validated inline Steps or an existing Template, optionally uploading up to 10 local files with a 20 MiB aggregate direct-upload limit. Use a /http/import Step inside steps for remote files or Tus resumable uploads for larger uploads.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `files` | array | No | Up to 10 local files to upload and process together in this Assembly, with a 20 MiB (20,971,520 byte) aggregate direct-upload limit. Use remote import or Tus resumable uploads for larger uploads. |
| `steps` | object | No | Named Assembly Steps. Each Step needs a robot; additional Robot-specific options are accepted. The :original Step must use /upload/handle, and a /upload/handle Step must be named :original. Use /http/import to import remote URLs. Required unless template_id is supplied. |
| `fields` | object | No | Scalar form fields exposed to Assembly Steps as variables. |
| `notify_url` | string | No | HTTPS URL that should receive the completed Assembly notification. |
| `template_id` | string | No | Existing Transloadit Template ID to run. Required unless steps is supplied. |
| `allow_steps_override` | boolean | No | Allow supplied steps to override Steps from template_id. Must be true when both template_id and steps are supplied. |

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

**Slug:** `TRANSLOADIT_GET_ASSEMBLY_STATUS`

Retrieve the latest state, uploads, warnings, and results for one Assembly. This performs one status fetch and does not poll. Transloadit limits status requests to 3 per second for the same Assembly ID.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `assembly_id` | string | Yes | Assembly ID returned by creation or listing. |

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

**Slug:** `TRANSLOADIT_LIST_ASSEMBLIES`

Return one page of Assemblies in descending creation order, optionally filtered by state, date range, or keywords.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `type` | string ("all" | "uploading" | "executing" | "canceled" | "completed" | "failed" | "request_aborted") | No | Assembly state to return. |
| `to_date` | string | No | Latest creation time in UTC as YYYY-MM-DD HH:MM:SS; omit for the provider's current-time default. |
| `keywords` | array | No | Keywords to match in Assembly metadata. |
| `from_date` | string | No | Earliest creation time in UTC as YYYY-MM-DD HH:MM:SS. |
| `page_size` | integer | No | Number of Assemblies requested for this page. The provider has not documented a maximum. |
| `next_cursor` | string | No | Opaque continuation returned by a previous call. Omit for the first page. When present, its page size and filters override explicitly supplied values. |

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

### Replay Assembly

**Slug:** `TRANSLOADIT_REPLAY_ASSEMBLY`

Retry a crashed Assembly while its original input files remain recoverable, optionally reparsing its Template.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `assembly_id` | string | Yes | Crashed Assembly ID to replay. |
| `reparse_template` | boolean | No | Use the Template's current Steps instead of replaying the original parsed Steps. |

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

### Replay Assembly Notification

**Slug:** `TRANSLOADIT_REPLAY_ASSEMBLY_NOTIFICATION`

Resend a completed Assembly's result notification to the notify_url configured on that Assembly.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `assembly_id` | string | Yes | Completed Assembly whose original notification should be sent again. |

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