Skip to content
Start in the sandbox
All connectors
Descript logo

Descript

Content creation & media

Move briefs, assets and sign-offs through Descript without chasing between tools.

12 ways to read, 2 ways to write, each write switched on by you.

Try this in the sandboxBring us a workflow

Quality checks

Built and tested with example responses.

  1. Ready to connect: doneEvery listed action is built in.
  2. Built and tested with example responses: doneEach action is built from the provider’s published API and tested against example responses, errors, rate limits and paging.
Descript with Nexra

Connected, approved, proven.

The things teams do most with Descript, an example flow with a person in the loop, and what Nexra keeps as proof.

Top actions

  • Run Underlord agent editagent_edits.createApproval by rule
  • Import media from URLsmedia_imports.createApproval by rule
  • List agent modelsagent_models.listRead

Example flow

  1. Descript · List agent modelsagent_models.listDone
  2. Descript · Run Underlord agent editagent_edits.createMaker-checker
  3. Nexra · Record the decision and result in the evidence chainProven

Example workflow. Routine runs go through on their own. Only a change your rules flag, such as one over a limit you set, waits for the right person, who sees the exact change and the rule before it reaches Descript.

What gets logged

  • Whether it ran on its own or who approved it, and under which rule
  • A fingerprint of the exact request sent to Descript
  • Descript's reply: what it created or changed
  • One entry in the evidence chain, linked to the one before

Try this in the sandbox

Run the whole flow with test data in your sandbox, then connect your own account when you are ready to go live.

Try this in the sandboxBring us a workflow

For developers

Technical detail

Descript projects, compositions, media, jobs, drive search and transcripts, plus URL media imports and Underlord agent edits through the Descript API (beta).

Descript API docs
Source actions
12
Destination actions
2
Data types
12

What you can map

Reads are always available. Writes are off until you switch them on for a connection, and governed writes follow your policies.

agent edits1
  • Run Underlord agent editDestinationNot retried automaticallyApproval before production

    Runs Descript's Underlord agent on a project (or creates one) from a natural-language instruction, for example adding Studio Sound or removing filler words. Returns a job to poll.

agent models1
  • List agent modelsSource

    Models and aliases accepted by agent_edits.create, with relative cost tiers.

compositions1
  • List project compositionsSource

    Compositions (timelines) in a project, with duration and media type.

drive items1
  • Search the DriveSource

    Ranked search across project names, folder names, media file names, composition text and transcripts.

jobs2
  • Get job statusSource

    Status of an import, agent or publish job, with per-file import results and credits used.

  • List jobsSourceIncremental

    Import and agent jobs from the last 7 days by default (up to 30 days back).

media files1
  • List project media filesSource

    Media files in a project (keyed by display path) with type and duration.

media imports1
  • Import media from URLsDestinationNot retried automaticallyApproval before production

    Creates a project (or adds to one) from media URLs, optionally builds a composition, and starts transcription. Returns a job to poll.

projects2
  • Get projectSource

    One project with counts of its media files, compositions and existing share pages.

  • List projectsSourceIncremental

    Projects in the token's Drive, with name, date and folder filters.

published projects1
  • Get published projectSource

    Metadata for a share page by its URL slug: title, duration, type, privacy and subtitles.

publishes1
  • List project share pagesSource

    Share pages already published from a project, with URL, access level and dates. Read only.

status1
  • Check API statusSource

    Validates the token and returns the Drive it is tied to and the API version.

transcripts1
  • Export transcriptSource

    Exports a composition's transcript as plain text, Markdown, HTML, RTF or SRT subtitles.

Access and limits

Authentication
Descript personal API token
Plans and access
Any Descript plan with access to API tokens. Imports use the plan's media minutes and agent edits use AI credits. Each personal API token is tied to one Drive and inherits its creator's permissions there. The API is in beta.
Test environment
Descript has no sandbox. Use a separate Drive (and its own token) for testing; imports and agent edits consume real media minutes and AI credits.
Rate limits
Descript returns HTTP 429 with Retry-After, X-RateLimit-Remaining and X-RateLimit-Consumed when a limit is reached; Nexra waits for Retry-After on reads. The published-project endpoint documents 1,000 requests per hour per user. Other per-endpoint limits are not published.
Pagination
Projects and jobs use cursor pagination (pagination.next_cursor, limit up to 100). Search returns at most 100 ranked results in one page.
Provider events
Import, agent and publish jobs accept a per-request callback_url. Nexra does not set it; poll jobs.get instead. Flows run on demand, on a schedule, or when a scheduled check finds new or changed records.

Before you build a flow

  • The Descript API is in beta.
  • Not implemented on purpose: publishing (POST /jobs/publish creates a share page, which can be public), job cancellation (DELETE /jobs/{job_id}) and any delete. Existing share pages can still be read through projects.get and published_projects.get.
  • Edit in Descript (POST /edit_in_descript/schema) is a partner API that requires Descript's approval and is not offered.
  • Direct file uploads are not offered: they need a second binary PUT to a signed URL, which Nexra recipes do not perform. Import media from a URL Descript can fetch (public or pre-signed, supporting HTTP Range requests). YouTube URLs are not accepted by Descript.
  • Rendered video or audio cannot be downloaded through the API without publishing. Transcripts are available as text, Markdown, HTML, RTF or SRT (DOCX is binary and not offered).
  • Job history covers the last 7 days by default and at most 30 days.
  • Each token is limited to one Drive; projects on another Drive return an error.
  • There is no create, update or rename endpoint for projects or folders other than creating a project through an import or agent edit. No comments, users or analytics endpoints are documented.
  • media_imports.create and agent_edits.create spend media minutes and AI credits. Both are marked billable, never retried automatically, and Descript answers HTTP 402 when the plan runs out.

Developer reference

  1. Create the Descript credentials described above with the narrowest permissions your flows need.
  2. In Nexra, open Connect, then Connections, then New connection, choose Descript, enter its settings and credentials, and tick only the write actions you need. Connection guide
  3. Test the connection, then use its actions as flow sources and destinations. Flow guide
Descript docsAPI referenceDescript docsAuthenticationDescript docsRate limits

Machine-readable detail: GET /api/public/connect/connectors/descript and the Connections API.