View as Markdown
Transloadit icon

Transloadit ACTION

Create Assembly

Create a new assembly to process files using a specified template and steps. See the documentation
  • Action
  • Writes data
  • API key
  • SDK
  • MCP

IMPLEMENTATION

Call this tool

Connect a user's Transloadit account once, then configure and run Create Assembly from your backend or agent.

import { PipedreamClient } from "@pipedream/sdk"

const pd = new PipedreamClient({
  projectId: process.env.PIPEDREAM_PROJECT_ID!,
  clientId: process.env.PIPEDREAM_CLIENT_ID!,
  clientSecret: process.env.PIPEDREAM_CLIENT_SECRET!,
  projectEnvironment: "production",
})

const result = await pd.actions.run({
  id: "transloadit-create-assembly",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    transloadit: { authProvisionId: "apn_xxxxxxx" },
    allowStepsOverride: true,
    templateId: "Template ID",
  },
})

console.log(result)

SCHEMA

Inputs

Pipedream supplies the connected account. Your application provides the operation-specific values below. Dynamic inputs are resolved against that user's account.

Create Assembly inputs
Property Type Description
allowStepsOverride Allow Steps Override boolean
Set this to false to disallow Overruling Templates at Runtime. If you set this to false then Template Id and Steps will be mutually exclusive and you may only supply one of those parameters. Recommended when deploying Transloadit in untrusted environments. This makes sense to set as part of a Template, rather than on the Assembly itself when creating it.
Required
templateId Template ID string
The ID of the Template that contains your Assembly Instructions. If you set Allow steps Override to false then steps and Template Id will be mutually exclusive and you may only supply one of these parameters.
Optional Dynamic
steps Steps object
Assembly Instructions comprise all the Steps executed on uploaded/imported files by the Transloadit back-end during file conversion or encoding. See the documentation for more information.
Optional
notifyUrl Notify URL string
Transloadit can send a Pingback to your server when the Assembly is completed. We'll send the Assembly status in a form url-encoded JSON string inside of a transloadit field in a multipart POST request to the URL supplied here.
Optional
quiet Quiet boolean
Set this to true to reduce the response from an Assembly POST request to only the necessary fields. This prevents any potentially confidential information being leaked to the end user who is making the Assembly request. A successful Assembly will only include the ok and assembly_id fields. An erroneous Assembly will only include the error, http_code, message and assembly_id fields. The full Assembly Status will then still be sent to the Notify URL if one was specified.
Optional

REFERENCE

Tool details

Behavior hints are published with the component in the Pipedream registry and surface as MCP tool annotations, so an agent can reason about a tool before it calls it.

Registry key
transloadit-create-assembly
Version
0.0.3
App
Transloadit
Authentication
API key
Read-only
No
Destructive
No
Open world
Yes