Connect Descript to Your AI Agent

Provide a project UUID and a concrete editing instruction, or identify a composition to publish. AI can submit the job and organize its completed result.

9 tools API key

Try a Descript Task

Copy a prompt into your agent with the oo Skill installed. Add your page links and source notes before running it.

oo Skill Descript

Edit a Project from Your Instructions

Submit natural-language editing instructions to an existing project and inspect the resulting job.

/oo Descript: Use Descript Underlord to edit project [project UUID], composition [composition ID if needed], with instructions [editing instructions]. Return the job ID, check completion, and summarize the result with the project URL.

Publish a Selected Composition

Publish the selected project composition with your output and access settings, then collect the completed result.

/oo Descript: Publish Descript project [project UUID], composition [composition ID], as [Audio or Video] with access [access level] and resolution [resolution if video]. Check the job and return the available share and download URLs when complete.

Start Working with Descript

  1. Install OOMOL

    Set up oo CLI and the oo Skill in your agent.

    Install OOMOL →
  2. Connect Descript

    Connect with a Drive-scoped Descript personal API token.

    Connect Descript →
  3. Give Your Agent a Task

    Use /oo with the pages to read, the changes to make, and where to save the result.

    Connection Guide →

Choose Your Agent

  • Create a token under Descript Settings > API tokens for the intended Drive.

Descript Tools

Descript projects contain media, compositions, and published outputs. Underlord editing, media import, and publishing run as asynchronous jobs whose status and results can be inspected.

Read Projects and Job Progress

Read projects, media and composition metadata, published links, job status and results; cancel a running job.

Submit Editing, Import, and Publishing Jobs

Read agent model options, submit Underlord editing instructions, import URL-hosted media, and publish or republish a composition.

9 tools

List Projects

List projects accessible to the Drive associated with the Descript API token.

descript.list_projects

Get Project

Get a Descript project with its media, compositions, and published links.

descript.get_project

List Jobs

List recent Descript jobs with optional project, type, time, and pagination filters.

descript.list_jobs

Get Job

Get the current state and type-specific result of a Descript job.

descript.get_job

Cancel Job

Cancel a running Descript job.

descript.cancel_job

List Agent Models

List the current Descript Underlord models and stable aliases.

descript.list_agent_models

Prompt Agent

Submit an asynchronous Underlord request to create or edit a Descript project.

descript.prompt_agent

Import Media

Import URL-hosted media into a new or existing Descript project asynchronously.

descript.import_media

Publish Project

Publish or republish a Descript composition and produce share and download URLs asynchronously.

descript.publish_project

Frequently Asked Questions

Will an editing request return the finished media immediately?

No. It returns a job ID; check the job for completion and its result.

How can I bring source media into a project?

Provide accessible media URLs for an import job and identify an existing project or create a new one.

Can I choose who can access a published composition?

Yes. Publishing supports public, unlisted, Drive, or private access settings. Review the intended access before publishing or republishing.

Connect Descript

About Descript ↗