Descript
AI-powered video and audio editing API for media import, Underlord edits, publishing, transcripts, jobs, and projects
Tools
| Name | Description |
|---|---|
import_mediaCreate or update a project by importing URL-based media, direct-upload placeholders, media sequences, and compositions. | Create or update a project by importing URL-based media, direct-upload placeholders, media sequences, and compositions. |
upload_direct_media_filePUT file bytes to a signed upload URL returned by the import media endpoint. | PUT file bytes to a signed upload URL returned by the import media endpoint. |
agent_editRun an Underlord agent edit against an existing project/composition or create a new project from a prompt. | Run an Underlord agent edit against an existing project/composition or create a new project from a prompt. |
publish_projectPublish a project composition to a Descript share URL and signed download URL. | Publish a project composition to a Descript share URL and signed download URL. |
export_transcriptExport a project composition transcript as txt, Markdown, HTML, RTF, or DOCX and write it to the file service. | Export a project composition transcript as txt, Markdown, HTML, RTF, or DOCX and write it to the file service. |
list_jobsList recent jobs with optional project, type, cursor, and date filters. | List recent jobs with optional project, type, cursor, and date filters. |
get_jobRetrieve a job by ID. | Retrieve a job by ID. |
cancel_jobCancel a running Descript job. | Cancel a running Descript job. |
list_projectsList projects with official filters and cursor pagination. | List projects with official filters and cursor pagination. |
get_projectGet detailed project metadata, media files, and compositions. | Get detailed project metadata, media files, and compositions. |
check_statusValidate the Descript API token and API availability. The official docs mark this endpoint as work in progress. | Validate the Descript API token and API availability. The official docs mark this endpoint as work in progress. |
create_edit_in_descript_import_urlCreate a one-time partner import URL for the Edit in Descript flow. | Create a one-time partner import URL for the Edit in Descript flow. |
get_published_project_metadataRetrieve metadata and signed download URL information for a published Descript project slug. | Retrieve metadata and signed download URL information for a published Descript project slug. |
custom_api_callMake a custom call to the Descript Public API. | Make a custom call to the Descript Public API. |
Triggers
| Name | Description |
|---|---|
job_callback_receivedReceive Descript dynamic job callbacks for import, agent, and publish jobs. | Receive Descript dynamic job callbacks for import, agent, and publish jobs. |
job_status_changedPoll Descript jobs and emit jobs whose state, result status, or timestamp changed after the initial baseline. | Poll Descript jobs and emit jobs whose state, result status, or timestamp changed after the initial baseline. |
project_updatedPoll Descript projects sorted by updated time and emit projects changed after the initial baseline. | Poll Descript projects sorted by updated time and emit projects changed after the initial baseline. |
Quick Start
import { WeavzClient } from '@weavz-io/sdk'
const weavz = new WeavzClient({ apiKey: 'wvz_...' })
const result = await weavz.actions.execute('descript', 'import_media', {
workspaceId: '550e8400-e29b-41d4-a716-446655440000',
integrationAlias: 'descript',
input: { /* ... */ },
})Related Integrations
Works well with
Frequently Asked Questions
How do I connect Descript to my app?
Use Weavz Hosted Connect for API Key authentication. Install the SDK, create a connection through the connect portal or API, then execute tools programmatically.
What tools does Descript support?
Descript supports 14 tools including Import Media, Upload Direct Media File, Agent Edit, Publish Project Media, Export Transcript, and more.
Can I use Descript with AI agents?
Yes. Add Descript to an MCP server in Tool Mode or Code Mode. Code Mode provides 3 meta-tools with on-demand API discovery so agents can compose stateful workflows without loading every action schema up front.
How do I connect Descript to ChatGPT or Claude?
Open the Weavz connector setup, sign in, choose a workspace, and add Descript as an approved app. ChatGPT, Claude, and other remote MCP clients can then call the scoped Descript tools exposed by that workspace.
Does Descript work with Claude Code, Cursor, Codex, and local agents?
Yes. Remote and local MCP clients can connect to a Weavz MCP endpoint for the workspace. Local coding agents can also use the Weavz CLI to inspect apps, discover actions, run approved Descript work, and execute Code Mode workflows from a terminal.
What can I ask an AI agent to do with Descript?
Descript exposes 14 tools, including Import Media, Upload Direct Media File, Agent Edit, Publish Project Media, Export Transcript, and more. Use Weavz to keep credentials scoped, require approval for sensitive work, and audit what the agent did.
Can Descript be used in stateful agent workflows?
Yes. Agents can combine Descript tools with Filesystem, State KV, Human Gates, input partials, and other workspace integrations while keeping execution scoped to the selected workspace or end user.
What authentication does Descript use?
Descript uses API Key. Weavz stores credentials securely and uses them for authorized action execution.
How much does the Descript integration cost?
The Descript integration is included on all Weavz plans including the free tier with 20,000 actions per month. No credit card required.
What triggers does Descript support?
Descript supports 3 triggers including Job Callback Received, Job Status Changed, Project Updated.
Connect Descript in minutes
Get 20,000 free action executions every month. No credit card required.