{
"error": "unauthorized",
"message": "Missing or invalid authentication token"
}
{
"error": "rate_limit_exceeded",
"message": "Too many requests. Please try again later."
}
List agent models
List the currently available agent models and the aliases that resolve to them.
The model parameter on POST /jobs/agent accepts any
value listed under availableModels[].id or aliases[].id. Aliases let you target
the latest
recommended model for a given tier without chasing version bumps — for example,
passing claude-opus always routes to whichever Claude Opus version Descript
currently recommends.
The catalog changes as models launch and retire, so this endpoint’s live response
is the source of truth — the example below is an abridged illustration, not the
full list.
Cost tiers are coarse buckets — low, medium, high — useful for showing
users a relative price/performance signal. Exact pricing is reported per job via
the ai_credits_used field on GET /jobs/.
When model is omitted on POST /jobs/agent, the request defaults to auto, which
selects a recommended model for your account. auto is a medium-cost option. For an
auto request, result.resolved_model on GET /jobs/ reports
auto; for an explicit model or alias it reports the canonical id that ran.
Friendly aliases that resolve to one of the availableModels at
request time. Pass any alias id as model and the agent job
result's result.resolved_model (on
GET /jobs/{job_id}) will report the canonical
id that actually ran.
Show child attributes
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Descript Help Center","description":"User guides and documentation for Descript, a text-based video and audio editor.","colors":{"primary":"#651A39","light":"#CDCDFE","dark":"#F73B3B"},"logo":{"light":"https://mintcdn.com/descript-5bf56f3f/cSbTRRN32pg3UC1d/images/01a_Logo_2_color_Dark.png?fit=max\u0026auto=format\u0026n=cSbTRRN32pg3UC1d\u0026q=85\u0026s=5d5e4bea817ea025e6f7daf713a7fcfe","dark":"https://mintcdn.com/descript-5bf56f3f/cSbTRRN32pg3UC1d/images/01b_Logo_2_color_Light.png?fit=max\u0026auto=format\u0026n=cSbTRRN32pg3UC1d\u0026q=85\u0026s=90296d892f5b71071480e08d18b959b8"},"favicon":"https://mintcdn.com/descript-5bf56f3f/cSbTRRN32pg3UC1d/images/02a_Monogram_Primary.png?fit=max\u0026auto=format\u0026n=cSbTRRN32pg3UC1d\u0026q=85\u0026s=0dcc0c665590f0d18907633e2c109a25","api":{"openapi":"developers/openapi.json"},"appearance":{"default":"system"},"background":{"color":{"light":"#fdfcfc","dark":"#110A0D"}},"navbar":{"links":[]},"footer":{"socials":{"x":"https://x.com/descript","website":"https://www.descript.com","discord":"https://discord.com/channels/764925197379174411/960303941789294602","reddit":"https://www.reddit.com/r/Descript","facebook":"https://www.facebook.com/descriptapp"}},"fonts":{"heading":{"family":"Booton SemiBold","weight":500},"body":{"family":"Booton Regular","weight":500}},"styling":{"eyebrows":"breadcrumbs","latex":false},"integrations":{"ga4":{"measurementId":"G-5C5EVM1H51"},"posthog":{"apiKey":"phc_w3ZqFHxxJraLWo3LU7wfDkCEhJZLo0X22W9e0VFu2Vu","sessionRecording":true}},"contextual":{"options":["copy","view","assistant","chatgpt","claude","perplexity","grok","aistudio","mcp","cursor","vscode","download-spec","download-pdf"],"display":"header"},"interaction":{"drilldown":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"descript-5bf56f3f","hasAudioNarration":false,"actualSubdomain":"descript-5bf56f3f","customDomains":["help.descript.com","docs.descriptapi.com"],"gitSource":{"type":"github","owner":"descriptinc","repo":"descript","deployBranch":"main","contentDirectory":"help-center","isPrivate":true,"mountPath":"","label":"","isBase":true},"chroma":{"liveDeploymentHistoryId":"6aea4ba3686df1f3186fbd49","collectionId":"79ffc07a-e967-425d-9d18-798a9401dd6a","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6aea4ba3686df1f3186fbd49"},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"REMOVE_BRANDING":{"status":"ENABLED"},"CONTEXTUAL_FEEDBACK":{"status":"ENABLED"},"CODE_SNIPPET_FEEDBACK":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6aea5bdc7e77426133be5c41","clientVersion":"0.0.4054","searchFilterCounts":[{"language":"default","tag":"Help Center","count":334},{"language":"default","tag":"SquadCast","count":67},{"language":"default","tag":"Script editing","count":34},{"language":"default","tag":"Export \u0026 share","count":33},{"language":"default","tag":"Record","count":28},{"language":"default","tag":"Visuals","count":28},{"language":"default","tag":"Add \u0026 manage media","count":25},{"language":"default","tag":"Effects, animations, transitions","count":23},{"language":"default","tag":"Troubleshooting","count":20},{"language":"default","tag":"Billing, payments, plans","count":19}],"searchSettings":{"isFiltersEnabled":false,"showContentSnippets":true,"maxResults":12}},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true,"deflection":{"enabled":true,"type":"link","url":"http://descript.zendesk.com/hc/en-us/requests/new"}},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instinct-self-updating-docs","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"byok-sep-25","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-updated-9-15","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"style.css","content":".effect-anchor{scroll-margin-top:6rem}tr:has(.effect-anchor:target){background-color:rgba(101,26,57,.07)}.dark tr:has(.effect-anchor:target){background-color:rgba(205,205,254,.1)}tr:has(.effect-anchor) td ul{margin:0}.custom-card{backdrop-filter:brightness(1.06);-webkit-backdrop-filter:brightness(1.06);border:1.5px solid rgba(0,0,0,.12);border-radius:1rem;transition:transform .15s ease,box-shadow .15s ease,border-color .15s ease}.custom-card:hover{transform:translateY(-2px);box-shadow:0 4px 8px rgba(0,0,0,.08)}.dark .custom-card{border-color:rgba(255,255,255,.14)}.dark .custom-card:hover{border-color:rgba(255,255,255,.22)}"}],"page":{"pagePath":"developers/api-reference/agent/list-agent-models","slug":"/developers/api-reference/agent/list-agent-models","pageMetadata":{"title":"List agent models","openapi":"GET /agent/models","noindex":true,"description":"List the currently available agent models and the aliases that resolve to them.\n\nThe `model` parameter on [POST /jobs/agent](#operation/agentEditJob) accepts any\nvalue listed under `availableModels[].id` or `aliases[].id`. Aliases let you target\nthe latest\nrecommended model for a given tier without chasing version bumps — for example,\npassing `claude-opus` always routes to whichever Claude Opus version Descript\ncurrently recommends.\n\nThe catalog changes as models launch and retire, so this endpoint's live response\nis the source of truth — the example below is an abridged illustration, not the\nfull list.\n\nCost tiers are coarse buckets — `low`, `medium`, `high` — useful for showing\nusers a relative price/performance signal. Exact pricing is reported per job via\nthe `ai_credits_used` field on [GET /jobs/{job_id}](#operation/getJob).\n\nWhen `model` is omitted on `POST /jobs/agent`, the request defaults to `auto`, which\nselects a recommended model for your account. `auto` is a `medium`-cost option. For an\n`auto` request, `result.resolved_model` on [GET /jobs/{job_id}](#operation/getJob) reports\n`auto`; for an explicit model or alias it reports the canonical id that ran.\n","href":"/developers/api-reference/agent/list-agent-models"},"description":{"compiledSource":"\"use strict\";\nconst {Fragment: _Fragment, jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n a: \"a\",\n code: \"code\",\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_Fragment, {\n children: [_jsx(_components.p, {\n children: \"List the currently available agent models and the aliases that resolve to them.\"\n }), \"\\n\", _jsxs(_components.p, {\n children: [\"The \", _jsx(_components.code, {\n children: \"model\"\n }), \" parameter on \", _jsx(_components.a, {\n href: \"#operation/agentEditJob\",\n children: \"POST /jobs/agent\"\n }), \" accepts any\\nvalue listed under \", _jsx(_components.code, {\n children: \"availableModels[].id\"\n }), \" or \", _jsx(_components.code, {\n children: \"aliases[].id\"\n }), \". Aliases let you target\\nthe latest\\nrecommended model for a given tier without chasing version bumps — for example,\\npassing \", _jsx(_components.code, {\n children: \"claude-opus\"\n }), \" always routes to whichever Claude Opus version Descript\\ncurrently recommends.\"]\n }), \"\\n\", _jsx(_components.p, {\n children: \"The catalog changes as models launch and retire, so this endpoint’s live response\\nis the source of truth — the example below is an abridged illustration, not the\\nfull list.\"\n }), \"\\n\", _jsxs(_components.p, {\n children: [\"Cost tiers are coarse buckets — \", _jsx(_components.code, {\n children: \"low\"\n }), \", \", _jsx(_components.code, {\n children: \"medium\"\n }), \", \", _jsx(_components.code, {\n children: \"high\"\n }), \" — useful for showing\\nusers a relative price/performance signal. Exact pricing is reported per job via\\nthe \", _jsx(_components.code, {\n children: \"ai_credits_used\"\n }), \" field on \", _jsx(_components.a, {\n href: \"#operation/getJob\",\n children: \"GET /jobs/\"\n }), \".\"]\n }), \"\\n\", _jsxs(_components.p, {\n children: [\"When \", _jsx(_components.code, {\n children: \"model\"\n }), \" is omitted on \", _jsx(_components.code, {\n children: \"POST /jobs/agent\"\n }), \", the request defaults to \", _jsx(_components.code, {\n children: \"auto\"\n }), \", which\\nselects a recommended model for your account. \", _jsx(_components.code, {\n children: \"auto\"\n }), \" is a \", _jsx(_components.code, {\n children: \"medium\"\n }), \"-cost option. For an\\n\", _jsx(_components.code, {\n children: \"auto\"\n }), \" request, \", _jsx(_components.code, {\n children: \"result.resolved_model\"\n }), \" on \", _jsx(_components.a, {\n href: \"#operation/getJob\",\n children: \"GET /jobs/\"\n }), \" reports\\n\", _jsx(_components.code, {\n children: \"auto\"\n }), \"; for an explicit model or alias it reports the canonical id that ran.\"]\n })]\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"List agent models","openapi":"GET /agent/models","noindex":true,"description":"List the currently available agent models and the aliases that resolve to them.\n\nThe `model` parameter on [POST /jobs/agent](#operation/agentEditJob) accepts any\nvalue listed under `availableModels[].id` or `aliases[].id`. Aliases let you target\nthe latest\nrecommended model for a given tier without chasing version bumps — for example,\npassing `claude-opus` always routes to whichever Claude Opus version Descript\ncurrently recommends.\n\nThe catalog changes as models launch and retire, so this endpoint's live response\nis the source of truth — the example below is an abridged illustration, not the\nfull list.\n\nCost tiers are coarse buckets — `low`, `medium`, `high` — useful for showing\nusers a relative price/performance signal. Exact pricing is reported per job via\nthe `ai_credits_used` field on [GET /jobs/{job_id}](#operation/getJob).\n\nWhen `model` is omitted on `POST /jobs/agent`, the request defaults to `auto`, which\nselects a recommended model for your account. `auto` is a `medium`-cost option. For an\n`auto` request, `result.resolved_model` on [GET /jobs/{job_id}](#operation/getJob) reports\n`auto`; for an explicit model or alias it reports the canonical id that ran.\n","href":"/developers/api-reference/agent/list-agent-models"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":["/_mintlify/custom/descript-5bf56f3f/2dc3a904ed64e2d6/analytics.js","/_mintlify/custom/descript-5bf56f3f/0f2d12095d1f7fa5/legacy-hash-redirect.js"],"openApiReferenceData":{"operation":{"tags":["API Endpoints"],"summary":"List agent models","security":["b20ffee3-0d93-4db7-afa9-6a76b1d37812"],"description":"List the currently available agent models and the aliases that resolve to them.\n\nThe `model` parameter on [POST /jobs/agent](#operation/agentEditJob) accepts any\nvalue listed under `availableModels[].id` or `aliases[].id`. Aliases let you target\nthe latest\nrecommended model for a given tier without chasing version bumps — for example,\npassing `claude-opus` always routes to whichever Claude Opus version Descript\ncurrently recommends.\n\nThe catalog changes as models launch and retire, so this endpoint's live response\nis the source of truth — the example below is an abridged illustration, not the\nfull list.\n\nCost tiers are coarse buckets — `low`, `medium`, `high` — useful for showing\nusers a relative price/performance signal. Exact pricing is reported per job via\nthe `ai_credits_used` field on [GET /jobs/{job_id}](#operation/getJob).\n\nWhen `model` is omitted on `POST /jobs/agent`, the request defaults to `auto`, which\nselects a recommended model for your account. `auto` is a `medium`-cost option. For an\n`auto` request, `result.resolved_model` on [GET /jobs/{job_id}](#operation/getJob) reports\n`auto`; for an explicit model or alias it reports the canonical id that ran.\n","operationId":"listAgentModels","responses":{"200":"09c22769-212b-4e2b-895e-73ae8a51d08d","401":"047c7550-00ce-43b9-852e-53c488ff0a34","429":"ea84acca-1619-45d6-a4b2-f10814905d6d"},"method":"get","type":"path","servers":["a768f050-c5b4-4ea7-8d39-6bdbe0c0c89a"],"path":"/agent/models","baseUrlOptions":["https://descriptapi.com/v1"],"title":"List agent models","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{},"responses":{"09c22769-212b-4e2b-895e-73ae8a51d08d":{"description":"Available agent models and aliases","content":{"application/json":{"schema":{"type":"object","required":["availableModels","aliases"],"properties":{"availableModels":{"type":"array","description":"Canonical model ids currently advertised by the public agent API,\neach tagged with a coarse cost tier.\n","items":{"type":"object","required":["id","cost"],"properties":{"id":{"type":"string","description":"Canonical model id to pass as `model` on `POST /jobs/agent`.","example":"claude-opus-5.5","isRequired":true,"uniqueKey":"availableModels.items.[INDEX].id","typeLabel":"string"},"cost":{"type":"string","enum":["low","medium","high"],"description":"Relative cost tier for this model.","example":"high","isRequired":true,"uniqueKey":"availableModels.items.[INDEX].cost","typeLabel":"enum\u003cstring>"}},"uniqueKey":"availableModels.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"availableModels","typeLabel":"object[]"},"aliases":{"type":"array","description":"Friendly aliases that resolve to one of the `availableModels` at\nrequest time. Pass any alias `id` as `model` and the agent job\nresult's `result.resolved_model` (on\n[GET /jobs/{job_id}](#operation/getJob)) will report the canonical\nid that actually ran.\n","items":{"type":"object","required":["id","resolvesTo","description","cost"],"properties":{"id":{"type":"string","description":"Alias id callers can pass as `model`.","example":"claude-opus","isRequired":true,"uniqueKey":"aliases.items.[INDEX].id","typeLabel":"string"},"resolvesTo":{"type":"string","description":"Canonical model id this alias currently resolves to.","example":"claude-opus-5.5","isRequired":true,"uniqueKey":"aliases.items.[INDEX].resolvesTo","typeLabel":"string"},"description":{"type":"string","description":"Human-readable description of the alias's intent.","example":"Tracks stable Anthropic Claude Opus","isRequired":true,"uniqueKey":"aliases.items.[INDEX].description","typeLabel":"string"},"cost":{"type":"string","enum":["low","medium","high"],"description":"Relative cost tier of the model this alias resolves to.","example":"high","isRequired":true,"uniqueKey":"aliases.items.[INDEX].cost","typeLabel":"enum\u003cstring>"}},"uniqueKey":"aliases.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"aliases","typeLabel":"object[]"}},"uniqueKey":"","typeLabel":"object"},"examples":{"default_models":{"title":"default_models","value":{"availableModels":[{"id":"auto","cost":"medium"},{"id":"claude-opus-5.5","cost":"high"},{"id":"claude-haiku-5.5","cost":"low"}],"aliases":[{"id":"claude-opus","resolvesTo":"claude-opus-5.5","description":"Tracks stable Anthropic Claude Opus","cost":"high"}]}}},"exampleType":"examples"}},"exampleType":"examples"},"047c7550-00ce-43b9-852e-53c488ff0a34":{"description":"Unauthorized - missing or invalid authentication token","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","example":"unauthorized","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"message":{"type":"string","example":"Missing or invalid authentication token","isRequired":true,"uniqueKey":"message","typeLabel":"string"}},"required":["error","message"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"unauthorized","message":"Missing or invalid authentication token"}}},"exampleType":"generated"}},"exampleType":"generated"},"ea84acca-1619-45d6-a4b2-f10814905d6d":{"description":"Too many requests - rate limit exceeded.\nUse the `Retry-After` header to determine when to retry.\n","headers":{"Retry-After":{"description":"Number of seconds to wait before retrying the request","schema":{"type":"integer"},"example":30},"X-RateLimit-Remaining":{"description":"Number of requests remaining in the current rate limit window","schema":{"type":"integer"},"example":0},"X-RateLimit-Consumed":{"description":"Number of requests consumed in the current rate limit window","schema":{"type":"integer"},"example":100}},"content":{"application/json":{"schema":{"description":"Rate limit exceeded response. When this error is returned, the response includes headers\nto help you implement proper retry logic:\n- `Retry-After`: Number of seconds to wait before retrying\n- `X-RateLimit-Remaining`: Requests remaining in current window\n- `X-RateLimit-Consumed`: Requests consumed in current window\n","type":"object","properties":{"error":{"type":"string","description":"Error code indicating rate limit was exceeded","example":"rate_limit_exceeded","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"message":{"type":"string","description":"Human-readable error message","example":"Too many requests","isRequired":true,"uniqueKey":"message","typeLabel":"string"}},"required":["error","message"],"uniqueKey":"","typeLabel":"object"},"examples":{"rate_limit":{"title":"rate_limit","value":{"error":"rate_limit_exceeded","message":"Too many requests. Please try again later."}}},"exampleType":"examples"}},"exampleType":"examples"}},"security":{"b20ffee3-0d93-4db7-afa9-6a76b1d37812":{"bearerAuth":{"type":"http","scheme":"bearer","description":"Personal API token created in Descript Settings → API Tokens. See the Authentication section for details.","scopes":[],"schemeName":"bearerAuth"}}},"servers":{"a768f050-c5b4-4ea7-8d39-6bdbe0c0c89a":{"url":"https://descriptapi.com/v1"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","description":"Personal API token created in Descript Settings → API Tokens. See the Authentication section for details.","scopes":[],"schemeName":"bearerAuth"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Personal API token created in Descript Settings → API Tokens. See the Authentication section for details.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"bearerAuth","name":"Authorization"}],"title":"bearerAuth"}]},"originalFileLocation":"developers/openapi.json"},"subdomain":"descript-5bf56f3f","siteName":"Descript Help Center","title":"List agent models - Descript Help Center","relatedPagesConfig":{"enabled":true,"limit":5,"mode":"automatic"},"navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-09-24T23:21:12.288Z","originalFileLocation":"developers/api-reference/agent/list-agent-models.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"List the currently available agent models and the aliases that resolve to them. The model parameter on POST /jobs/agent accepts any value listed under availableModels[].id or aliases[].id. Aliases let you target the latest recommended model for a given tier without chasing version bumps — for example, passing claude-opus always routes to whichever Claude Opus version Descript currently recommends. The catalog changes as models launch and retire, so this endpoint\u0026#x27;s live response is the source of truth — the example below is an abridged illustration, not the full list. Cost tiers are coarse buckets — low, medium, high — useful for showing users a relative price/performance signal. Exact pricing is reported per job via the ai_credits_used field on GET /jobs/{job_id}. When model is omitted on POST /jobs/agent, the request defaults to auto, which selects a recommended model for your account. auto is a medium-cost option. For an auto request, result.resolved_model on GET /jobs/{job_id} reports auto; for an explicit model or alias it reports the canonical id that ran.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Descript Help Center\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003cmeta data-mint-head name=\"robots\" content=\"noindex\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/descript-5bf56f3f/kFeqHqu-v8e5VpSc/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/descript-5bf56f3f/kFeqHqu-v8e5VpSc/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/descript-5bf56f3f/kFeqHqu-v8e5VpSc/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/descript-5bf56f3f/kFeqHqu-v8e5VpSc/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/descript-5bf56f3f/kFeqHqu-v8e5VpSc/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/descript-5bf56f3f/kFeqHqu-v8e5VpSc/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/descript-5bf56f3f/kFeqHqu-v8e5VpSc/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/descript-5bf56f3f/kFeqHqu-v8e5VpSc/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/descript-5bf56f3f/kFeqHqu-v8e5VpSc/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"List agent models - Descript Help Center\">\u003cmeta data-mint-head property=\"og:description\" content=\"List the currently available agent models and the aliases that resolve to them. The model parameter on POST /jobs/agent accepts any value listed under availableModels[].id or aliases[].id. Aliases let you target the latest recommended model for a given tier without chasing version bumps — for example, passing claude-opus always routes to whichever Claude Opus version Descript currently recommends. The catalog changes as models launch and retire, so this endpoint\u0026#x27;s live response is the source of truth — the example below is an abridged illustration, not the full list. Cost tiers are coarse buckets — low, medium, high — useful for showing users a relative price/performance signal. Exact pricing is reported per job via the ai_credits_used field on GET /jobs/{job_id}. When model is omitted on POST /jobs/agent, the request defaults to auto, which selects a recommended model for your account. auto is a medium-cost option. For an auto request, result.resolved_model on GET /jobs/{job_id} reports auto; for an explicit model or alias it reports the canonical id that ran.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Descript Help Center\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://help.descript.com/developers/api-reference/agent/list-agent-models\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://descript-5bf56f3f.mintlify.app/_mintlify/api/og/v2?division=Agent\u0026amp;title=List+agent+models\u0026amp;description=List+the+currently+available+agent+models+and+the+aliases+that+resolve+to+them.%0A%0AThe+%60model%60+parameter+on+%5BPOST+%2Fjobs%2Fagent%5D%28%23operation%2FagentEditJob%29+accepts+an\u0026amp;theme=f81376d507a7ea740b835510\u0026amp;signature=0ed4df5f1643ed832b4f8a98caa1c46f9dab8df46bee1422056fae7bb530efa5\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"List agent models - Descript Help Center\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"List the currently available agent models and the aliases that resolve to them. The model parameter on POST /jobs/agent accepts any value listed under availableModels[].id or aliases[].id. Aliases let you target the latest recommended model for a given tier without chasing version bumps — for example, passing claude-opus always routes to whichever Claude Opus version Descript currently recommends. The catalog changes as models launch and retire, so this endpoint\u0026#x27;s live response is the source of truth — the example below is an abridged illustration, not the full list. Cost tiers are coarse buckets — low, medium, high — useful for showing users a relative price/performance signal. Exact pricing is reported per job via the ai_credits_used field on GET /jobs/{job_id}. When model is omitted on POST /jobs/agent, the request defaults to auto, which selects a recommended model for your account. auto is a medium-cost option. For an auto request, result.resolved_model on GET /jobs/{job_id} reports auto; for an explicit model or alias it reports the canonical id that ran.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://descript-5bf56f3f.mintlify.app/_mintlify/api/og/v2?division=Agent\u0026amp;title=List+agent+models\u0026amp;description=List+the+currently+available+agent+models+and+the+aliases+that+resolve+to+them.%0A%0AThe+%60model%60+parameter+on+%5BPOST+%2Fjobs%2Fagent%5D%28%23operation%2FagentEditJob%29+accepts+an\u0026amp;theme=f81376d507a7ea740b835510\u0026amp;signature=0ed4df5f1643ed832b4f8a98caa1c46f9dab8df46bee1422056fae7bb530efa5\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/descript-5bf56f3f/kFeqHqu-v8e5VpSc/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Descript Help Center\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#651A39\">\u003clink data-mint-head rel=\"canonical\" href=\"https://help.descript.com/developers/api-reference/agent/list-agent-models\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/developers/api-reference/agent/list-agent-models.md\">","siteName":"Descript Help Center","nav":{"global":null,"tabs":[{"tab":"Help Center","pages":[{"title":"Help Center","href":""}]},{"tab":"SquadCast","pages":[{"title":"SquadCast","href":"/squadcast/quickstart"}]},{"tab":"Developers","icon":"square-terminal","groups":[{"group":"Get started","pages":[{"title":"Descript API","href":"/developers"},{"title":"Quickstart","href":"/developers/get-started/quickstart"},{"title":"Authentication","href":"/developers/get-started/authentication"}]},{"group":"Guides","pages":[{"title":"Using the CLI","href":"/developers/guides/cli"},{"title":"Direct file upload","href":"/developers/guides/direct-upload"},{"title":"Rate limiting","href":"/developers/guides/rate-limiting"}]},{"group":"MCP","pages":[{"title":"Descript MCP","href":"/developers/mcp/overview"}]},{"group":"Partner integrations","pages":[{"title":"Edit in Descript","href":"/developers/partners/edit-in-descript"},{"title":"Export from Descript","href":"/developers/partners/export-from-descript"}]},{"group":"API endpoints","pages":[{"title":"API endpoints","sidebarTitle":"Overview","href":"/developers/api-reference/overview"},{"group":"Import","pages":[{"title":"Import media and sequences","openapi":"POST /jobs/import/project_media","href":"/developers/api-reference/import/import-project-media"},{"title":"Import media to drive library","openapi":"POST /jobs/import/drive_media","href":"/developers/api-reference/import/import-drive-media"}]},{"group":"Agent","pages":[{"title":"Agent edit","openapi":"POST /jobs/agent","description":"Use a background agent to create and edit projects using a natural language prompt.\n\n- **Edit existing project**: Provide a `project_id` to edit an existing project\n- **Target a specific composition**: Provide both `project_id` and `composition_id` to direct the agent to a specific composition within the project\n- **Create new project**: Provide a `project_name` instead of `project_id` to create a new project\n\n### Common use cases\n- Create new content: \"create a 30-second video about cooking tips\"\n- Apply audio effects: \"add studio sound to every clip\"\n- Remove filler words: \"remove all filler words from the transcript\"\n- Create highlights: \"create a 30-second highlight reel\"\n- Content editing: \"remove the section from 1:30 to 2:15\"\n\n### Async Operations\n\nAgent edits run in the background and return a `job_id`. Monitor progress via the [GET /jobs/{job_id}](#operation/getJob) endpoint.\n\n### Dynamic webhook\n\nIf `callback_url` is provided, Descript will POST the job status to that URL when the job completes or fails.\nThe payload will match the format returned by [GET /jobs/{job_id}](#operation/getJob).\n","href":"/developers/api-reference/agent/create-agent-edit"},{"title":"List agent models","openapi":"GET /agent/models","href":"/developers/api-reference/agent/list-agent-models"}]},{"group":"Jobs","pages":[{"title":"Get job status","openapi":"GET /jobs/{job_id}","description":"Retrieve the status of any job.\n\nThe response format varies based on job type and includes type-specific fields. A finished job has `job_state: stopped`. Read `result.status` for the outcome: `success`, or `error` when the job failed. Import jobs can also return `partial`. An individual file inside `result.media_status` uses `failed` when that file did not import.\n","href":"/developers/api-reference/jobs/get-job"},{"title":"List jobs","openapi":"GET /jobs","href":"/developers/api-reference/jobs/list-jobs"},{"title":"Cancel job","openapi":"DELETE /jobs/{job_id}","href":"/developers/api-reference/jobs/cancel-job"},{"title":"Publish project media","openapi":"POST /jobs/publish","href":"/developers/api-reference/jobs/publish-project"}]},{"group":"Projects","pages":[{"title":"List projects","openapi":"GET /projects","href":"/developers/api-reference/projects/list-projects"},{"title":"Get project details","openapi":"GET /projects/{project_id}","href":"/developers/api-reference/projects/get-project"},{"title":"Search a drive","openapi":"GET /search","href":"/developers/api-reference/projects/search"}]},{"group":"Export","pages":[{"title":"Export project transcript","openapi":"POST /export/transcript","href":"/developers/api-reference/export/export-transcript"}]},{"group":"Status","pages":[{"title":"Check API status","openapi":"GET /status","href":"/developers/api-reference/status/get-status"}]},{"group":"Partner endpoints","pages":[{"title":"Create Import URL","openapi":"POST /edit_in_descript/schema","href":"/developers/api-reference/partners/edit-in-descript-schema"},{"title":"Get Published Project Metadata","openapi":"GET /published_projects/{publishedProjectSlug}","href":"/developers/api-reference/partners/published-project-metadata"}]}]}]}]},"basePath":"","title":"List agent models - Descript Help Center","buildId":"dpl_345ReqzYaAjzS9QpeJemsKdb7KDj","deploymentId":"dpl_345ReqzYaAjzS9QpeJemsKdb7KDj","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-C8RPHPxo.js","utils-0BK-9q6z.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-DfjzsUJT.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-B4v9psJ4.js","snippetPresets-CpTQv-Ez.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-BNP-Fvr0.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-BSgu6h1D.js","shallow-Biv1i9Gs.js","getApiPlaygroundDisplay-BoGOXhtF.js","CodeSnippet-DvQoT18_.js","CodeSnippets-Dnpa15xT.js","Page-Buji1S4J.js","getPastedJson-xAIyhUFE.js","icon-S6FBih11.js","MethodPill-SaYeUZyk.js","DuplicateIcon-Cs-p3v2Q.js","createIcon-DjCFEoHq.js","DynamicMarkdown-BcnBltEQ.js","SectionHeading-BUBl0eEF.js","axios-vUo_bRtp.js","Markdown-h4cOoD8d.js","clsx-B2v50t8t.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-DJnKvr0g.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-BHrrjR1K.js"]}