Runway for AI agents
Agents read Runway at once. Changes and sends are held for a person's approval by default.
About Runway
Runway provides generative AI APIs for creating and transforming video, images, audio, avatars, voices, and media workflows.
What an agent can do in Runway
Every Runway action is classed by the platform as a read, a change or a send. Reads run at once. Changes and sends are held for a person by default.
Runs at once (reads)
Looks things up in Runway without asking first. 8 actions.
- Get DocumentGet one Runway knowledge document, including its full content and the avatars that currently use it.
- Get OrganizationReturn the connected Runway organization's credit balance, monthly credit spend cap, exact per-model quotas, and current daily generation usage.
- Get TaskGet the current status, cost, output URLs, and failure details for a Runway generation task. Runway does not update a task more often than every five seconds.
- Get UsageReturn daily Runway credit usage by model for an optional UTC date range of up to 90 days.
- Get WorkflowGet a published Runway workflow version and its graph so node IDs and output keys can be inspected before running the workflow.
- Get Workflow InvocationGet the current status, completed node output URLs, and node or invocation failure details for a Runway workflow invocation.
- List DocumentsList Runway knowledge documents one page at a time, with sorting and an opaque continuation cursor. List results omit full document content.
- List WorkflowsList the connected account's published Runway workflows and their available versions, ordered as returned by Runway.
Held for approval by default (changes and sends)
Held for a person's approval by default. The approval is recorded and the action is sent once, never twice, with 10 seconds to undo. 11 actions.
- Cancel TaskCancel a running Runway task or delete its task record. Returns success only when Runway confirms the operation; an already absent task remains a 404 error.
- Create DocumentCreate a Runway knowledge document from markdown or plain text for reuse by avatar workflows.
- Create Ephemeral UploadCreate only a temporary Runway media upload slot and return its presigned multipart form details and runway:// URI. This action does not upload file bytes; POST them separately to upload_url using fie
- Delete DocumentPermanently delete a Runway knowledge document by its ID.
- Generate ImageStart a Runway text-to-image or reference-guided image generation task and return its task ID and estimated credit cost.
- Generate Sound EffectGenerate an audio effect from a text prompt and return the task ID and estimated credit cost.
- Generate SpeechSynthesize speech with Runway using an exact model-specific voice and option contract, then return the task ID and estimated credit cost.
- Run WorkflowInvoke a published Runway workflow, optionally overriding graph node outputs, and return the created workflow invocation ID.
- Update DocumentChange the name, content, or both for an existing Runway knowledge document. Provide at least one of name or content.
- Upscale ImageStart a Runway image upscaling task and return its task ID and estimated credit cost.
- Upscale VideoStart a Runway video upscaling task and return its task ID and estimated credit cost.
Changes wait in Needs you
Changes and sends in Runway are held for a person's approval by default. The approval is recorded, and the action is sent once, never twice, with 10 seconds to undo.
Runway questions
Can an agent change data in Runway on its own?
Not by default. Changes and sends in Runway are held for a person's approval. The approval is recorded, and the action is sent once, never twice, with 10 seconds to undo.
What can an agent read in Runway?
This connector lists 8 read actions. Reads run at once, without waiting for approval.
How does Runway connect?
It connects with API key. Connectors are built and maintained by third-party developers; availability is confirmed during scoping.