The 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.
Job result (only present when job_state is stopped)
ImportSuccessResult
ImportErrorResult
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/jobs/get-job","slug":"/developers/api-reference/jobs/get-job","pageMetadata":{"title":"Get job status","openapi":"GET /jobs/{job_id}","noindex":true,"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"},"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 code: \"code\",\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_Fragment, {\n children: [_jsx(_components.p, {\n children: \"Retrieve the status of any job.\"\n }), \"\\n\", _jsxs(_components.p, {\n children: [\"The response format varies based on job type and includes type-specific fields. A finished job has \", _jsx(_components.code, {\n children: \"job_state: stopped\"\n }), \". Read \", _jsx(_components.code, {\n children: \"result.status\"\n }), \" for the outcome: \", _jsx(_components.code, {\n children: \"success\"\n }), \", or \", _jsx(_components.code, {\n children: \"error\"\n }), \" when the job failed. Import jobs can also return \", _jsx(_components.code, {\n children: \"partial\"\n }), \". An individual file inside \", _jsx(_components.code, {\n children: \"result.media_status\"\n }), \" uses \", _jsx(_components.code, {\n children: \"failed\"\n }), \" when that file did not import.\"]\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":"Get job status","openapi":"GET /jobs/{job_id}","noindex":true,"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"}}},"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":"Get job status","security":["553db24d-265f-4fb7-9337-97332f521ecc"],"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","operationId":"getJob","parameters":["3d194be4-7368-4e8b-9bb4-20facf375f87"],"responses":{"200":"1aa8df64-6817-484b-a659-cf9544c406ef","401":"0e0104ee-e2c3-4392-9540-fc502a0db8ad","403":"f644a160-e353-419d-8726-241bd3447455","404":"9e800a4f-0f73-418b-96ce-e86e7d943309","429":"0b54aab0-70b6-47ee-aaa1-3ef4427ce761"},"method":"get","type":"path","servers":["a768f050-c5b4-4ea7-8d39-6bdbe0c0c89a"],"path":"/jobs/{job_id}","baseUrlOptions":["https://descriptapi.com/v1"],"title":"Get job status","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"3d194be4-7368-4e8b-9bb4-20facf375f87":{"in":"path","name":"job_id","description":"The job ID","required":true,"schema":{"type":"string","format":"uuid","isRequired":true,"description":"The job ID","uniqueKey":"","typeLabel":"string\u003cuuid>"}}},"responses":{"1aa8df64-6817-484b-a659-cf9544c406ef":{"description":"Job status retrieved successfully","content":{"application/json":{"schema":{"oneOf":[{"type":"object","description":"Status of an async job. The response structure varies based on the job type.\nUse the `job_type` field to determine which fields will be present.\n","required":["job_id","job_type","job_state","created_at","drive_id","project_id","project_url"],"properties":{"job_id":{"type":"string","format":"uuid","description":"Unique identifier for the job","example":"6dc3f30a-58c2-4174-96a6-dc18cf3c7776","isRequired":true,"uniqueKey":"oneOf.0.job_id","typeLabel":"string\u003cuuid>"},"job_type":{"type":"string","enum":["import/project_media"],"description":"Type of job","isRequired":true,"uniqueKey":"oneOf.0.job_type","typeLabel":"enum\u003cstring>"},"job_state":{"type":"string","enum":["queued","running","stopped","cancelled"],"description":"Current state of the job:\n- queued: Job is waiting to start\n- running: Job is actively processing\n- stopped: Job has finished (check result.status for outcome)\n- cancelled: Job was cancelled by user\n","example":"stopped","isRequired":true,"uniqueKey":"oneOf.0.job_state","typeLabel":"enum\u003cstring>"},"created_at":{"type":"string","format":"date-time","description":"When the job was created","example":"2025-11-18T10:30:00Z","isRequired":true,"uniqueKey":"oneOf.0.created_at","typeLabel":"string\u003cdate-time>"},"drive_id":{"type":"string","format":"uuid","description":"The drive ID","example":"c9c5c47e-158a-49f7-846b-4f6ee2a229a2","isRequired":true,"uniqueKey":"oneOf.0.drive_id","typeLabel":"string\u003cuuid>"},"project_id":{"type":"string","format":"uuid","description":"The project ID","example":"9f36ee32-5a2c-47e7-b1a3-94991d3e3ddb","isRequired":true,"uniqueKey":"oneOf.0.project_id","typeLabel":"string\u003cuuid>"},"project_url":{"type":"string","format":"uri","description":"URL to access the project in Descript web app. When a composition ID is available in the result, the URL includes a composition short ID suffix.","example":"https://web.descript.com/9f36ee32-5a2c-47e7-b1a3-94991d3e3ddb","isRequired":true,"uniqueKey":"oneOf.0.project_url","typeLabel":"string\u003curi>"},"stopped_at":{"type":"string","format":"date-time","description":"When the job stopped (only present when job_state is stopped or cancelled)","example":"2025-11-18T10:35:00Z","uniqueKey":"oneOf.0.stopped_at","typeLabel":"string\u003cdate-time>"},"progress":{"type":"object","description":"Progress information for the workflow (only present when job_state is running)","properties":{"label":{"type":"string","description":"Human-readable label describing the current action","example":"Importing media...","isRequired":true,"uniqueKey":"oneOf.0.progress.label","typeLabel":"string"},"percent":{"type":"integer","description":"Percentage of the workflow that has been completed","example":50,"uniqueKey":"oneOf.0.progress.percent","typeLabel":"integer"},"last_update_at":{"type":"string","format":"date-time","description":"When the progress was last updated","example":"2025-11-18T10:32:00Z","uniqueKey":"oneOf.0.progress.last_update_at","typeLabel":"string\u003cdate-time>"}},"required":["label"],"uniqueKey":"oneOf.0.progress","typeLabel":"object"},"result":{"oneOf":[{"type":"object","title":"ImportSuccessResult","description":"Job result (only present when job_state is stopped)","required":["status","media_status","media_seconds_used"],"properties":{"status":{"type":"string","enum":["success","partial"],"description":"- success: All media imported successfully\n- partial: Some media imported successfully, some failed\n","example":"success","isRequired":true,"uniqueKey":"oneOf.0.result.oneOf.0.status","typeLabel":"enum\u003cstring>"},"media_status":{"type":"object","description":"Status of each media item in the import.\nKeys are the media reference IDs from the request.\n","additionalProperties":{"type":"object","description":"Status information for a single media import","properties":{"status":{"type":"string","enum":["success","failed"],"description":"Status of this individual media import","isRequired":true,"uniqueKey":"oneOf.0.result.oneOf.0.media_status.additionalProperties.status","typeLabel":"enum\u003cstring>"},"duration_seconds":{"type":"number","format":"float","description":"Duration of the imported media in seconds (only present for successful imports)","example":125.5,"uniqueKey":"oneOf.0.result.oneOf.0.media_status.additionalProperties.duration_seconds","typeLabel":"number\u003cfloat>"},"error_message":{"type":"string","description":"Error message if the import failed (only present for failed imports)","example":"URL is not accessible or does not support Range requests","uniqueKey":"oneOf.0.result.oneOf.0.media_status.additionalProperties.error_message","typeLabel":"string"}},"required":["status"],"uniqueKey":"oneOf.0.result.oneOf.0.media_status.additionalProperties","typeLabel":"object"},"example":{"Misc/intro.mp4":{"status":"success","duration_seconds":10.5},"demo.mp4":{"status":"success","duration_seconds":125}},"isRequired":true,"uniqueKey":"oneOf.0.result.oneOf.0.media_status","typeLabel":"object"},"media_seconds_used":{"type":"integer","description":"Total media seconds consumed by this import","example":75,"isRequired":true,"uniqueKey":"oneOf.0.result.oneOf.0.media_seconds_used","typeLabel":"integer"},"created_compositions":{"type":"array","description":"Compositions created during import","items":{"type":"object","properties":{"id":{"type":"string","example":"0daabc7a-437a-43eb-b04b-b398d502f393","uniqueKey":"oneOf.0.result.oneOf.0.created_compositions.items.[INDEX].id","typeLabel":"string"},"name":{"type":"string","example":"Rough Cut","uniqueKey":"oneOf.0.result.oneOf.0.created_compositions.items.[INDEX].name","typeLabel":"string"}},"uniqueKey":"oneOf.0.result.oneOf.0.created_compositions.items.[INDEX]","typeLabel":"object"},"uniqueKey":"oneOf.0.result.oneOf.0.created_compositions","typeLabel":"object[]"}},"uniqueKey":"oneOf.0.result.oneOf.0","typeLabel":"ImportSuccessResult · object"},{"type":"object","title":"ImportErrorResult","description":"Job result (only present when job_state is stopped)","required":["status","error_message"],"properties":{"status":{"type":"string","enum":["error"],"description":"Job failed completely","example":"error","isRequired":true,"uniqueKey":"oneOf.0.result.oneOf.1.status","typeLabel":"enum\u003cstring>"},"error_message":{"type":"string","description":"Human-readable error message","example":"Failed to import media files","isRequired":true,"uniqueKey":"oneOf.0.result.oneOf.1.error_message","typeLabel":"string"},"error_code":{"type":"string","description":"Machine-readable error code","example":"import_failed","uniqueKey":"oneOf.0.result.oneOf.1.error_code","typeLabel":"string"}},"uniqueKey":"oneOf.0.result.oneOf.1","typeLabel":"ImportErrorResult · object"}],"uniqueKey":"oneOf.0.result","typeLabel":"ImportSuccessResult · object | ImportErrorResult · object"}},"uniqueKey":"oneOf.0","typeLabel":"object"},{"type":"object","description":"Status of an async job. The response structure varies based on the job type.\nUse the `job_type` field to determine which fields will be present.\n","required":["job_id","job_type","job_state","created_at","drive_id","folder_id"],"properties":{"job_id":{"type":"string","description":"The job ID.","isRequired":true,"uniqueKey":"oneOf.1.job_id","typeLabel":"string"},"job_type":{"type":"string","enum":["import/drive_media"],"isRequired":true,"uniqueKey":"oneOf.1.job_type","typeLabel":"enum\u003cstring>"},"job_state":{"type":"string","enum":["queued","running","stopped","cancelled"],"isRequired":true,"uniqueKey":"oneOf.1.job_state","typeLabel":"enum\u003cstring>"},"created_at":{"type":"string","format":"date-time","description":"When the job was created.","isRequired":true,"uniqueKey":"oneOf.1.created_at","typeLabel":"string\u003cdate-time>"},"drive_id":{"type":"string","description":"The drive ID.","isRequired":true,"uniqueKey":"oneOf.1.drive_id","typeLabel":"string"},"folder_id":{"type":"string","description":"The target folder ID.","isRequired":true,"uniqueKey":"oneOf.1.folder_id","typeLabel":"string"},"stopped_at":{"type":"string","format":"date-time","description":"When the job stopped (only present when job_state is stopped or cancelled).","uniqueKey":"oneOf.1.stopped_at","typeLabel":"string\u003cdate-time>"},"drive_name":{"oneOf":[{"type":"string","description":"Human-readable name of the connected drive (workspace)","example":"My Team Workspace","uniqueKey":"oneOf.1.drive_name.oneOf.0","typeLabel":"string"},{"type":"null","description":"Human-readable name of the connected drive (workspace)","example":"My Team Workspace","uniqueKey":"oneOf.1.drive_name.oneOf.1","typeLabel":"null"}],"uniqueKey":"oneOf.1.drive_name","typeLabel":"string | null"},"progress":{"type":"object","description":"Progress information for the workflow (only present when job_state is running)","properties":{"label":{"type":"string","description":"Human-readable label describing the current action","isRequired":true,"uniqueKey":"oneOf.1.progress.label","typeLabel":"string"},"percent":{"type":"integer","description":"Percentage of the workflow that has been completed","uniqueKey":"oneOf.1.progress.percent","typeLabel":"integer"},"last_update_at":{"type":"string","format":"date-time","description":"When the progress was last updated","uniqueKey":"oneOf.1.progress.last_update_at","typeLabel":"string\u003cdate-time>"},"waiting_for_uploads":{"type":"boolean","description":"Whether the job is still waiting for direct uploads to finish","uniqueKey":"oneOf.1.progress.waiting_for_uploads","typeLabel":"boolean"},"uploaded_artifacts":{"type":"integer","description":"Number of direct upload files received so far","uniqueKey":"oneOf.1.progress.uploaded_artifacts","typeLabel":"integer"},"total_artifacts":{"type":"integer","description":"Total number of direct upload files expected","uniqueKey":"oneOf.1.progress.total_artifacts","typeLabel":"integer"}},"required":["label"],"uniqueKey":"oneOf.1.progress","typeLabel":"object"},"result":{"oneOf":[{"type":"object","properties":{"status":{"type":"string","enum":["success","partial"],"uniqueKey":"oneOf.1.result.oneOf.0.status","typeLabel":"enum\u003cstring>"},"media_status":{"type":"object","additionalProperties":{"type":"object","properties":{"status":{"type":"string","enum":["success","error"],"uniqueKey":"oneOf.1.result.oneOf.0.media_status.additionalProperties.status","typeLabel":"enum\u003cstring>"},"error_message":{"type":"string","uniqueKey":"oneOf.1.result.oneOf.0.media_status.additionalProperties.error_message","typeLabel":"string"},"duration_seconds":{"type":"number","uniqueKey":"oneOf.1.result.oneOf.0.media_status.additionalProperties.duration_seconds","typeLabel":"number"}},"uniqueKey":"oneOf.1.result.oneOf.0.media_status.additionalProperties","typeLabel":"object"},"uniqueKey":"oneOf.1.result.oneOf.0.media_status","typeLabel":"object"},"media_seconds_used":{"type":"number","uniqueKey":"oneOf.1.result.oneOf.0.media_seconds_used","typeLabel":"number"}},"uniqueKey":"oneOf.1.result.oneOf.0","typeLabel":"object"},{"type":"object","properties":{"status":{"type":"string","enum":["error"],"uniqueKey":"oneOf.1.result.oneOf.1.status","typeLabel":"enum\u003cstring>"},"error_message":{"type":"string","uniqueKey":"oneOf.1.result.oneOf.1.error_message","typeLabel":"string"}},"uniqueKey":"oneOf.1.result.oneOf.1","typeLabel":"object"}],"uniqueKey":"oneOf.1.result","typeLabel":"object"}},"uniqueKey":"oneOf.1","typeLabel":"object"},{"type":"object","description":"Status of an async job. The response structure varies based on the job type.\nUse the `job_type` field to determine which fields will be present.\n","required":["job_id","job_type","job_state","created_at","drive_id","project_id","project_url"],"properties":{"job_id":{"type":"string","format":"uuid","description":"Unique identifier for the job","example":"6dc3f30a-58c2-4174-96a6-dc18cf3c7776","isRequired":true,"uniqueKey":"oneOf.2.job_id","typeLabel":"string\u003cuuid>"},"job_type":{"type":"string","enum":["agent"],"description":"Type of job","example":"agent","isRequired":true,"uniqueKey":"oneOf.2.job_type","typeLabel":"enum\u003cstring>"},"job_state":{"type":"string","enum":["queued","running","stopped","cancelled"],"description":"Current state of the job:\n- queued: Job is waiting to start\n- running: Job is actively processing\n- stopped: Job has finished (check result.status for outcome)\n- cancelled: Job was cancelled by user\n","example":"stopped","isRequired":true,"uniqueKey":"oneOf.2.job_state","typeLabel":"enum\u003cstring>"},"created_at":{"type":"string","format":"date-time","description":"When the job was created","example":"2025-11-18T10:30:00Z","isRequired":true,"uniqueKey":"oneOf.2.created_at","typeLabel":"string\u003cdate-time>"},"drive_id":{"type":"string","format":"uuid","description":"The drive ID","example":"c9c5c47e-158a-49f7-846b-4f6ee2a229a2","isRequired":true,"uniqueKey":"oneOf.2.drive_id","typeLabel":"string\u003cuuid>"},"project_id":{"type":"string","format":"uuid","description":"The project ID","example":"9f36ee32-5a2c-47e7-b1a3-94991d3e3ddb","isRequired":true,"uniqueKey":"oneOf.2.project_id","typeLabel":"string\u003cuuid>"},"project_url":{"type":"string","format":"uri","description":"URL to access the project in Descript web app. When a composition ID is available in the result, the URL includes a composition short ID suffix.","example":"https://web.descript.com/9f36ee32-5a2c-47e7-b1a3-94991d3e3ddb","isRequired":true,"uniqueKey":"oneOf.2.project_url","typeLabel":"string\u003curi>"},"stopped_at":{"type":"string","format":"date-time","description":"When the job stopped (only present when job_state is stopped or cancelled)","example":"2025-11-18T10:35:00Z","uniqueKey":"oneOf.2.stopped_at","typeLabel":"string\u003cdate-time>"},"progress":{"type":"object","description":"Progress information for the workflow (only present when job_state is running)","properties":{"label":{"type":"string","description":"Human-readable label describing the current action","example":"Applying Studio Sound to clip 2...","isRequired":true,"uniqueKey":"oneOf.2.progress.label","typeLabel":"string"},"percent":{"type":"integer","description":"Percentage of the workflow that has been completed","example":50,"uniqueKey":"oneOf.2.progress.percent","typeLabel":"integer"},"last_update_at":{"type":"string","format":"date-time","description":"When the progress was last updated","example":"2025-11-18T10:32:00Z","uniqueKey":"oneOf.2.progress.last_update_at","typeLabel":"string\u003cdate-time>"}},"required":["label"],"uniqueKey":"oneOf.2.progress","typeLabel":"object"},"result":{"oneOf":[{"type":"object","title":"AgentSuccessResult","description":"Job result (only present when job_state is stopped)","required":["status","agent_response","project_changed"],"properties":{"status":{"type":"string","enum":["success"],"description":"Indicates successful completion","example":"success","isRequired":true,"uniqueKey":"oneOf.2.result.oneOf.0.status","typeLabel":"enum\u003cstring>"},"agent_response":{"type":"string","description":"AI response describing what was done","example":"I added Studio Sound to all 3 clips in your composition","isRequired":true,"uniqueKey":"oneOf.2.result.oneOf.0.agent_response","typeLabel":"string"},"project_changed":{"type":"boolean","description":"Whether the agent made modifications to the project","example":true,"isRequired":true,"uniqueKey":"oneOf.2.result.oneOf.0.project_changed","typeLabel":"boolean"},"media_seconds_used":{"type":"integer","description":"Media minutes (in seconds) consumed by this operation","example":34,"uniqueKey":"oneOf.2.result.oneOf.0.media_seconds_used","typeLabel":"integer"},"ai_credits_used":{"type":"integer","description":"AI credits consumed by this operation","example":5,"uniqueKey":"oneOf.2.result.oneOf.0.ai_credits_used","typeLabel":"integer"},"resolved_model":{"type":"string","description":"Model reported for this job: the canonical id for an explicit model or\nalias (e.g. `claude-opus-5.5` for `claude-opus`), `auto` for an `auto`\nrequest, or `inherited` when a resume keeps the conversation's model.\nPresent on jobs submitted via the public API after the model-aliases\nlaunch; older jobs may omit it.\n","example":"claude-opus-5.5","uniqueKey":"oneOf.2.result.oneOf.0.resolved_model","typeLabel":"string"},"conversation_id":{"type":"string","format":"uuid","description":"Conversation ID for this agent session. Pass this value as `conversation_id` in a\nsubsequent [POST /jobs/agent](#operation/agentEditJob) request to continue the conversation.\n","example":"a1b2c3d4-e5f6-7890-abcd-ef1234567890","uniqueKey":"oneOf.2.result.oneOf.0.conversation_id","typeLabel":"string\u003cuuid>"}},"uniqueKey":"oneOf.2.result.oneOf.0","typeLabel":"AgentSuccessResult · object"},{"type":"object","title":"AgentErrorResult","description":"Job result (only present when job_state is stopped)","required":["status","error_message"],"properties":{"status":{"type":"string","enum":["error"],"description":"The string `error`. A stopped agent job with this status did not complete.\nRead `error_message` for what went wrong.\n","example":"error","isRequired":true,"uniqueKey":"oneOf.2.result.oneOf.1.status","typeLabel":"enum\u003cstring>"},"error_message":{"type":"string","description":"Human-readable error message","example":"AI agent failed to process the request","isRequired":true,"uniqueKey":"oneOf.2.result.oneOf.1.error_message","typeLabel":"string"},"error_code":{"type":"string","description":"Machine-readable error code","example":"agent_execution_failed","uniqueKey":"oneOf.2.result.oneOf.1.error_code","typeLabel":"string"},"resolved_model":{"type":"string","description":"Model reported for this job: the canonical id for an explicit model or\nalias, `auto` for an `auto` request, or `inherited` when a resume keeps\nthe conversation's model. Present on jobs submitted via the public API\nafter the model-aliases launch; older jobs may omit it.\n","example":"claude-opus-5.5","uniqueKey":"oneOf.2.result.oneOf.1.resolved_model","typeLabel":"string"},"conversation_id":{"type":"string","format":"uuid","description":"Conversation ID for this agent session, if one was created before the error occurred.\n","example":"a1b2c3d4-e5f6-7890-abcd-ef1234567890","uniqueKey":"oneOf.2.result.oneOf.1.conversation_id","typeLabel":"string\u003cuuid>"}},"uniqueKey":"oneOf.2.result.oneOf.1","typeLabel":"AgentErrorResult · object"}],"uniqueKey":"oneOf.2.result","typeLabel":"AgentSuccessResult · object | AgentErrorResult · object"}},"uniqueKey":"oneOf.2","typeLabel":"object"},{"type":"object","description":"Status of an async job. The response structure varies based on the job type.\nUse the `job_type` field to determine which fields will be present.\n","required":["job_id","job_type","job_state","created_at","drive_id","project_id","project_url"],"properties":{"job_id":{"type":"string","format":"uuid","description":"Unique identifier for the job","example":"6dc3f30a-58c2-4174-96a6-dc18cf3c7776","isRequired":true,"uniqueKey":"oneOf.3.job_id","typeLabel":"string\u003cuuid>"},"job_type":{"type":"string","enum":["publish"],"description":"Type of job","isRequired":true,"uniqueKey":"oneOf.3.job_type","typeLabel":"enum\u003cstring>"},"job_state":{"type":"string","enum":["queued","running","stopped","cancelled"],"description":"Current state of the job:\n- queued: Job is waiting to start\n- running: Job is actively processing\n- stopped: Job has finished (check result.status for outcome)\n- cancelled: Job was cancelled by user\n","example":"stopped","isRequired":true,"uniqueKey":"oneOf.3.job_state","typeLabel":"enum\u003cstring>"},"created_at":{"type":"string","format":"date-time","description":"When the job was created","example":"2025-11-18T10:30:00Z","isRequired":true,"uniqueKey":"oneOf.3.created_at","typeLabel":"string\u003cdate-time>"},"drive_id":{"type":"string","format":"uuid","description":"The drive ID","example":"c9c5c47e-158a-49f7-846b-4f6ee2a229a2","isRequired":true,"uniqueKey":"oneOf.3.drive_id","typeLabel":"string\u003cuuid>"},"project_id":{"type":"string","format":"uuid","description":"The project ID","example":"9f36ee32-5a2c-47e7-b1a3-94991d3e3ddb","isRequired":true,"uniqueKey":"oneOf.3.project_id","typeLabel":"string\u003cuuid>"},"project_url":{"type":"string","format":"uri","description":"URL to access the project in Descript web app. When a composition ID is available in the result, the URL includes a composition short ID suffix.","example":"https://web.descript.com/9f36ee32-5a2c-47e7-b1a3-94991d3e3ddb","isRequired":true,"uniqueKey":"oneOf.3.project_url","typeLabel":"string\u003curi>"},"stopped_at":{"type":"string","format":"date-time","description":"When the job stopped (only present when job_state is stopped or cancelled)","example":"2025-11-18T10:35:00Z","uniqueKey":"oneOf.3.stopped_at","typeLabel":"string\u003cdate-time>"},"progress":{"type":"object","description":"Progress information for the workflow (only present when job_state is running)","properties":{"label":{"type":"string","description":"Human-readable label describing the current action","example":"Exporting composition...","isRequired":true,"uniqueKey":"oneOf.3.progress.label","typeLabel":"string"},"percent":{"type":"integer","description":"Percentage of the workflow that has been completed","example":50,"uniqueKey":"oneOf.3.progress.percent","typeLabel":"integer"},"last_update_at":{"type":"string","format":"date-time","description":"When the progress was last updated","example":"2025-11-18T10:32:00Z","uniqueKey":"oneOf.3.progress.last_update_at","typeLabel":"string\u003cdate-time>"},"composition_id":{"type":"string","description":"Composition being published (present when known)","example":"39677a40-1c43-4c36-8449-46cfbc4de2b5","uniqueKey":"oneOf.3.progress.composition_id","typeLabel":"string"},"share_url":{"type":"string","format":"uri","description":"Share URL when available before the job completes","example":"https://share.descript.com/view/abc123","uniqueKey":"oneOf.3.progress.share_url","typeLabel":"string\u003curi>"}},"required":["label"],"uniqueKey":"oneOf.3.progress","typeLabel":"object"},"result":{"oneOf":[{"type":"object","description":"Job result (only present when job_state is stopped)","required":["status","composition_id","share_url"],"properties":{"status":{"type":"string","enum":["success"],"description":"Indicates successful completion","isRequired":true,"uniqueKey":"oneOf.3.result.oneOf.0.status","typeLabel":"enum\u003cstring>"},"composition_id":{"type":"string","description":"Identifier of the published composition","example":"39677a40-1c43-4c36-8449-46cfbc4de2b5","isRequired":true,"uniqueKey":"oneOf.3.result.oneOf.0.composition_id","typeLabel":"string"},"share_url":{"type":"string","format":"uri","description":"Public URL to view the published content","example":"https://share.descript.com/view/abc123","isRequired":true,"uniqueKey":"oneOf.3.result.oneOf.0.share_url","typeLabel":"string\u003curi>"},"media_type":{"type":"string","enum":["Video","Audio"],"description":"The media type the composition was actually published as. For an audio-only composition published with the default Video request, this is Audio.\n","example":"Audio","uniqueKey":"oneOf.3.result.oneOf.0.media_type","typeLabel":"enum\u003cstring>"},"download_url":{"type":"string","format":"uri","description":"Time-limited signed URL to download the original published media file. Present when the job completed successfully and signing succeeded.\n","example":"https://storage.googleapis.com/bucket/object?X-Goog-Signature=...","uniqueKey":"oneOf.3.result.oneOf.0.download_url","typeLabel":"string\u003curi>"},"download_url_expires_at":{"type":"string","format":"date-time","description":"ISO 8601 time when download_url expires (if download_url is set)","uniqueKey":"oneOf.3.result.oneOf.0.download_url_expires_at","typeLabel":"string\u003cdate-time>"}},"uniqueKey":"oneOf.3.result.oneOf.0","typeLabel":"object"},{"type":"object","description":"Job result (only present when job_state is stopped)","required":["status","error_message"],"properties":{"status":{"type":"string","enum":["error"],"description":"Indicates the publish job failed","isRequired":true,"uniqueKey":"oneOf.3.result.oneOf.1.status","typeLabel":"enum\u003cstring>"},"error_message":{"type":"string","description":"Human-readable error message","example":"Export failed during render","isRequired":true,"uniqueKey":"oneOf.3.result.oneOf.1.error_message","typeLabel":"string"}},"uniqueKey":"oneOf.3.result.oneOf.1","typeLabel":"object"}],"uniqueKey":"oneOf.3.result","typeLabel":"object"}},"uniqueKey":"oneOf.3","typeLabel":"object"}],"uniqueKey":"","typeLabel":"object"},"examples":{"import_success":{"title":"import_success","value":{"job_id":"6dc3f30a-58c2-4174-96a6-dc18cf3c7776","job_type":"import/project_media","job_state":"stopped","created_at":"2025-11-18T10:30:00Z","stopped_at":"2025-11-18T10:35:00Z","drive_id":"c9c5c47e-158a-49f7-846b-4f6ee2a229a2","project_id":"9f36ee32-5a2c-47e7-b1a3-94991d3e3ddb","project_url":"https://web.descript.com/9f36ee32-5a2c-47e7-b1a3-94991d3e3ddb/0171c","result":{"status":"success","media_status":{"Misc/intro.mp4":{"status":"success","duration_seconds":10.5},"demo.mp4":{"status":"success","duration_seconds":125}},"media_seconds_used":136,"created_compositions":[{"id":"0171c","name":"Rough Cut"}]}}},"import_partial":{"title":"import_partial","value":{"job_id":"6dc3f30a-58c2-4174-96a6-dc18cf3c7776","job_type":"import/project_media","job_state":"stopped","created_at":"2025-11-18T10:30:00Z","stopped_at":"2025-11-18T10:35:00Z","drive_id":"c9c5c47e-158a-49f7-846b-4f6ee2a229a2","project_id":"9f36ee32-5a2c-47e7-b1a3-94991d3e3ddb","project_url":"https://web.descript.com/9f36ee32-5a2c-47e7-b1a3-94991d3e3ddb/0171c","result":{"status":"partial","media_status":{"Misc/intro.mp4":{"status":"success","duration_seconds":10.5},"demo.mp4":{"status":"success","duration_seconds":125},"outro.mp4":{"status":"failed","error_message":"URL is not accessible or does not support Range requests"}},"media_seconds_used":136,"created_compositions":[{"id":"0171c","name":"Rough Cut"}]}}},"agent_success":{"title":"agent_success","value":{"job_id":"6dc3f30a-58c2-4174-96a6-dc18cf3c7776","job_type":"agent","job_state":"stopped","created_at":"2025-11-18T10:30:00Z","stopped_at":"2025-11-18T10:32:00Z","drive_id":"c9c5c47e-158a-49f7-846b-4f6ee2a229a2","project_id":"9f36ee32-5a2c-47e7-b1a3-94991d3e3ddb","project_url":"https://web.descript.com/9f36ee32-5a2c-47e7-b1a3-94991d3e3ddb","result":{"status":"success","agent_response":"I added Studio Sound to all 3 clips in your composition","project_changed":true,"media_seconds_used":0,"ai_credits_used":150}}},"agent_error":{"title":"agent_error","value":{"job_id":"6dc3f30a-58c2-4174-96a6-dc18cf3c7776","job_type":"agent","job_state":"stopped","created_at":"2025-11-18T10:30:00Z","stopped_at":"2025-11-18T10:32:00Z","drive_id":"c9c5c47e-158a-49f7-846b-4f6ee2a229a2","project_id":"9f36ee32-5a2c-47e7-b1a3-94991d3e3ddb","project_url":"https://web.descript.com/9f36ee32-5a2c-47e7-b1a3-94991d3e3ddb","result":{"status":"error","error_message":"AI agent failed to process the request"}}},"job_running":{"title":"job_running","value":{"job_id":"6dc3f30a-58c2-4174-96a6-dc18cf3c7776","job_type":"import/project_media","job_state":"running","created_at":"2025-11-18T10:30:00Z","drive_id":"c9c5c47e-158a-49f7-846b-4f6ee2a229a2","project_id":"9f36ee32-5a2c-47e7-b1a3-94991d3e3ddb","project_url":"https://web.descript.com/9f36ee32-5a2c-47e7-b1a3-94991d3e3ddb"}},"agent_running":{"title":"agent_running","value":{"job_id":"6dc3f30a-58c2-4174-96a6-dc18cf3c7776","job_type":"agent","job_state":"running","created_at":"2025-11-18T10:30:00Z","drive_id":"c9c5c47e-158a-49f7-846b-4f6ee2a229a2","project_id":"9f36ee32-5a2c-47e7-b1a3-94991d3e3ddb","project_url":"https://web.descript.com/9f36ee32-5a2c-47e7-b1a3-94991d3e3ddb","progress":{"label":"Applying Studio Sound to clip 2","last_update_at":"2025-11-18T10:32:00Z"}}},"publish_success":{"title":"publish_success","value":{"job_id":"6dc3f30a-58c2-4174-96a6-dc18cf3c7776","job_type":"publish","job_state":"stopped","created_at":"2025-11-18T10:30:00Z","stopped_at":"2025-11-18T10:35:00Z","drive_id":"c9c5c47e-158a-49f7-846b-4f6ee2a229a2","project_id":"9f36ee32-5a2c-47e7-b1a3-94991d3e3ddb","project_url":"https://web.descript.com/9f36ee32-5a2c-47e7-b1a3-94991d3e3ddb/39677","result":{"status":"success","composition_id":"39677a40-1c43-4c36-8449-46cfbc4de2b5","share_url":"https://share.descript.com/view/abc123","download_url":"https://storage.googleapis.com/bucket/object?X-Goog-Signature=...","download_url_expires_at":"2025-11-18T11:35:00Z"}}},"publish_running":{"title":"publish_running","value":{"job_id":"6dc3f30a-58c2-4174-96a6-dc18cf3c7776","job_type":"publish","job_state":"running","created_at":"2025-11-18T10:30:00Z","drive_id":"c9c5c47e-158a-49f7-846b-4f6ee2a229a2","project_id":"9f36ee32-5a2c-47e7-b1a3-94991d3e3ddb","project_url":"https://web.descript.com/9f36ee32-5a2c-47e7-b1a3-94991d3e3ddb","progress":{"label":"Rendering video export","last_update_at":"2025-11-18T10:32:00Z","composition_id":"39677a40-1c43-4c36-8449-46cfbc4de2b5","share_url":"https://share.descript.com/view/abc123"}}},"publish_failed":{"title":"publish_failed","value":{"job_id":"6dc3f30a-58c2-4174-96a6-dc18cf3c7776","job_type":"publish","job_state":"stopped","created_at":"2025-11-18T10:30:00Z","stopped_at":"2025-11-18T10:31:00Z","drive_id":"c9c5c47e-158a-49f7-846b-4f6ee2a229a2","project_id":"9f36ee32-5a2c-47e7-b1a3-94991d3e3ddb","project_url":"https://web.descript.com/9f36ee32-5a2c-47e7-b1a3-94991d3e3ddb","result":{"status":"error","error_message":"Export failed during render"}}},"job_failed":{"title":"job_failed","value":{"job_id":"6dc3f30a-58c2-4174-96a6-dc18cf3c7776","job_type":"import/project_media","job_state":"stopped","created_at":"2025-11-18T10:30:00Z","stopped_at":"2025-11-18T10:31:00Z","drive_id":"c9c5c47e-158a-49f7-846b-4f6ee2a229a2","project_id":"9f36ee32-5a2c-47e7-b1a3-94991d3e3ddb","project_url":"https://web.descript.com/9f36ee32-5a2c-47e7-b1a3-94991d3e3ddb","result":{"status":"error","error_message":"Failed to download media file from URL"}}},"job_cancelled":{"title":"job_cancelled","value":{"job_id":"6dc3f30a-58c2-4174-96a6-dc18cf3c7776","job_type":"agent","job_state":"cancelled","created_at":"2025-11-18T10:30:00Z","stopped_at":"2025-11-18T10:31:00Z","drive_id":"c9c5c47e-158a-49f7-846b-4f6ee2a229a2","project_id":"9f36ee32-5a2c-47e7-b1a3-94991d3e3ddb","project_url":"https://web.descript.com/9f36ee32-5a2c-47e7-b1a3-94991d3e3ddb"}}},"exampleType":"examples"}},"exampleType":"examples"},"0e0104ee-e2c3-4392-9540-fc502a0db8ad":{"description":"Unauthorized - invalid or missing 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":{"unauthorized":{"title":"unauthorized","value":{"error":"unauthorized","message":"Missing or invalid authentication token"}}},"exampleType":"examples"}},"exampleType":"examples"},"f644a160-e353-419d-8726-241bd3447455":{"description":"Forbidden - user does not have access to this job","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","example":"forbidden","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"message":{"type":"string","example":"User does not have access to this resource","isRequired":true,"uniqueKey":"message","typeLabel":"string"}},"required":["error","message"],"uniqueKey":"","typeLabel":"object"},"examples":{"forbidden":{"title":"forbidden","value":{"error":"forbidden","message":"User does not have access to this job"}}},"exampleType":"examples"}},"exampleType":"examples"},"9e800a4f-0f73-418b-96ce-e86e7d943309":{"description":"Job not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","example":"not_found","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"message":{"type":"string","example":"Resource not found","isRequired":true,"uniqueKey":"message","typeLabel":"string"}},"required":["error","message"],"uniqueKey":"","typeLabel":"object"},"examples":{"not_found":{"title":"not_found","value":{"error":"not_found","message":"No job found for job_id \"6dc3f30a-58c2-4174-96a6-dc18cf3c7776\"."}}},"exampleType":"examples"}},"exampleType":"examples"},"0b54aab0-70b6-47ee-aaa1-3ef4427ce761":{"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":{"553db24d-265f-4fb7-9337-97332f521ecc":{"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":"Get job status - Descript Help Center","relatedPagesConfig":{"enabled":true,"limit":5,"mode":"automatic"},"navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-07T18:43:17.770Z","originalFileLocation":"developers/api-reference/jobs/get-job.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=\"Retrieve the status of any job. The 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.\">\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=\"Get job status - Descript Help Center\">\u003cmeta data-mint-head property=\"og:description\" content=\"Retrieve the status of any job. The 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.\">\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/jobs/get-job\">\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=Jobs\u0026amp;title=Get+job+status\u0026amp;description=Retrieve+the+status+of+any+job.%0A%0AThe+response+format+varies+based+on+job+type+and+includes+type-specific+fields.+A+finished+job+has+%60job_state%3A+stopped%60.+Read+%60\u0026amp;theme=f81376d507a7ea740b835510\u0026amp;signature=fd5eab0c06fbd7eb3089ed9d98d6f6a28a3d100a28eab948c7de15394ae6e52c\">\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=\"Get job status - Descript Help Center\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Retrieve the status of any job. The 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.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://descript-5bf56f3f.mintlify.app/_mintlify/api/og/v2?division=Jobs\u0026amp;title=Get+job+status\u0026amp;description=Retrieve+the+status+of+any+job.%0A%0AThe+response+format+varies+based+on+job+type+and+includes+type-specific+fields.+A+finished+job+has+%60job_state%3A+stopped%60.+Read+%60\u0026amp;theme=f81376d507a7ea740b835510\u0026amp;signature=fd5eab0c06fbd7eb3089ed9d98d6f6a28a3d100a28eab948c7de15394ae6e52c\">\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/jobs/get-job\">\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/jobs/get-job.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","href":"/developers/api-reference/agent/create-agent-edit"},{"title":"List agent models","openapi":"GET /agent/models","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"}]},{"group":"Jobs","pages":[{"title":"Get job status","openapi":"GET /jobs/{job_id}","href":"/developers/api-reference/jobs/get-job"},{"title":"List jobs","openapi":"GET /jobs","description":"List recent jobs with optional filtering by project or job type.\n\nBy default, jobs created within the last 7 days are returned. Use `created_after` and\n`created_before` to customize the time range. The maximum lookback is 30 days.\n\nResults are paginated. Use the `cursor` from the response `pagination.next_cursor` to\nfetch subsequent pages.\n\nQuery parameters allow you to filter the results:\n* Filter by `project_id` to see all jobs for a project\n* Filter by `type` to see specific job types (import/project_media, import/drive_media, agent, publish)\n","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":"Get job status - 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"]}