> ## Documentation Index
> Fetch the complete documentation index at: https://help.descript.com/llms.txt
> Use this file to discover all available pages before exploring further.

# API endpoints

> Browse every endpoint in the Descript API.

All endpoints live under `https://descriptapi.com/v1` and take a personal API token in the
`Authorization` header. Import, agent edit, and publish run as background jobs: each returns a
`job_id` right away, which you poll with [Get job status](/developers/api-reference/jobs/get-job) or
receive at a `callback_url`.

The full specification is available as [OpenAPI JSON](/developers/openapi.json).

## Import and edit

| Endpoint                                                                                   | Description                                                                                 |
| ------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------- |
| [`POST /jobs/import/project_media`](/developers/api-reference/import/import-project-media) | Import media into a new or existing project and create compositions.                        |
| [`POST /jobs/agent`](/developers/api-reference/agent/create-agent-edit)                    | Create or edit a project from a natural-language prompt, run by Underlord.                  |
| [`GET /agent/models`](/developers/api-reference/agent/list-agent-models)                   | List the agent models available to `POST /jobs/agent` and the aliases that resolve to them. |

## Publish and export

| Endpoint                                                                        | Description                                                                            |
| ------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------- |
| [`POST /jobs/publish`](/developers/api-reference/jobs/publish-project)          | Publish a composition to a shareable link and get download URLs for the rendered file. |
| [`POST /export/transcript`](/developers/api-reference/export/export-transcript) | Export a composition's transcript.                                                     |

## Jobs

| Endpoint                                                             | Description                                        |
| -------------------------------------------------------------------- | -------------------------------------------------- |
| [`GET /jobs/{job_id}`](/developers/api-reference/jobs/get-job)       | Get the status and result of any job.              |
| [`GET /jobs`](/developers/api-reference/jobs/list-jobs)              | List recent jobs, filtered by project or job type. |
| [`DELETE /jobs/{job_id}`](/developers/api-reference/jobs/cancel-job) | Cancel a running job.                              |

## Projects and search

| Endpoint                                                                       | Description                                                                                  |
| ------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------------- |
| [`GET /projects`](/developers/api-reference/projects/list-projects)            | List the projects in the token's Drive.                                                      |
| [`GET /projects/{project_id}`](/developers/api-reference/projects/get-project) | Get a project's media files, compositions, and existing publishes.                           |
| [`GET /search`](/developers/api-reference/projects/search)                     | Search project, folder, and media names, composition text, and transcripts across the Drive. |

## Status

| Endpoint                                                     | Description                                       |
| ------------------------------------------------------------ | ------------------------------------------------- |
| [`GET /status`](/developers/api-reference/status/get-status) | Check that the API is up and your token is valid. |

## Partner endpoints

These require partner access. See [Edit in Descript](/developers/partners/edit-in-descript) and
[Export from Descript](/developers/partners/export-from-descript).

| Endpoint                                                                                                          | Description                                                    |
| ----------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------- |
| [`POST /edit_in_descript/schema`](/developers/api-reference/partners/edit-in-descript-schema)                     | Create an import URL that opens your user's media in Descript. |
| [`GET /published_projects/{publishedProjectSlug}`](/developers/api-reference/partners/published-project-metadata) | Get metadata for a published project by its URL slug.          |


## Related topics

- [Call the API directly](/api-and-mcp/other-endpoints.md)
- [Connect Descript to Zapier](/api-and-mcp/zapier.md)
- [Descript API](/api-and-mcp/api.md)
- [Create a new SquadCast API secret key](/squadcast/api-key.md)
- [App settings](/account-and-app-settings/app-settings.md)