{
"error": "unauthorized",
"message": "Missing or invalid authentication token"
}
{
"error": "forbidden",
"message": "User does not have access to this resource"
}
{
"error": "not_found",
"message": "Resource not found"
}
{
"error": "rate_limit_exceeded",
"message": "Too many requests. Please try again later."
}
Get project details
Get a detailed project summary including all media files, compositions,
and existing publishes.
Returns the project’s id, name, drive_id, a map of media files (keyed by
display path) with type and duration, a list of compositions with id,
name, duration, and media type, and a list of successfully published
share pages with their URLs, access levels, and publish times.
Use this to inspect a project’s contents before editing or importing media,
or to retrieve existing share URLs without triggering a republish.
Full folder path for the project (e.g. "Clients/Acme/Videos"). Absent when the project is at the drive root.
Example:
"Clients/Acme/Videos"
{"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/projects/get-project","slug":"/developers/api-reference/projects/get-project","pageMetadata":{"title":"Get project details","openapi":"GET /projects/{project_id}","noindex":true,"description":"Get a detailed project summary including all media files, compositions,\nand existing publishes.\n\nReturns the project's id, name, drive_id, a map of media files (keyed by\ndisplay path) with type and duration, a list of compositions with id,\nname, duration, and media type, and a list of successfully published\nshare pages with their URLs, access levels, and publish times.\n\nUse this to inspect a project's contents before editing or importing media,\nor to retrieve existing share URLs without triggering a republish.\n","href":"/developers/api-reference/projects/get-project"},"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 p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_Fragment, {\n children: [_jsx(_components.p, {\n children: \"Get a detailed project summary including all media files, compositions,\\nand existing publishes.\"\n }), \"\\n\", _jsx(_components.p, {\n children: \"Returns the project’s id, name, drive_id, a map of media files (keyed by\\ndisplay path) with type and duration, a list of compositions with id,\\nname, duration, and media type, and a list of successfully published\\nshare pages with their URLs, access levels, and publish times.\"\n }), \"\\n\", _jsx(_components.p, {\n children: \"Use this to inspect a project’s contents before editing or importing media,\\nor to retrieve existing share URLs without triggering a republish.\"\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 project details","openapi":"GET /projects/{project_id}","noindex":true,"description":"Get a detailed project summary including all media files, compositions,\nand existing publishes.\n\nReturns the project's id, name, drive_id, a map of media files (keyed by\ndisplay path) with type and duration, a list of compositions with id,\nname, duration, and media type, and a list of successfully published\nshare pages with their URLs, access levels, and publish times.\n\nUse this to inspect a project's contents before editing or importing media,\nor to retrieve existing share URLs without triggering a republish.\n","href":"/developers/api-reference/projects/get-project"}}},"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 project details","description":"Get a detailed project summary including all media files, compositions,\nand existing publishes.\n\nReturns the project's id, name, drive_id, a map of media files (keyed by\ndisplay path) with type and duration, a list of compositions with id,\nname, duration, and media type, and a list of successfully published\nshare pages with their URLs, access levels, and publish times.\n\nUse this to inspect a project's contents before editing or importing media,\nor to retrieve existing share URLs without triggering a republish.\n","operationId":"getProject","security":["e3f60dbf-4988-40a6-b18e-e6a86aabc1cc"],"parameters":["031982ca-7b60-4808-9997-3a5c7352ac42"],"responses":{"200":"0b2e0191-37d2-48c4-826a-b224fd437ab6","400":"0d2385df-2668-45bc-8b48-e7425e543f46","401":"761e3595-3ba7-4dee-acf7-7fcc9954dcca","403":"9ce2e127-d759-4e47-b172-c75421957a51","404":"decd54ad-5961-4568-ac9e-7fe145f03a48","429":"0d888859-e141-4307-852c-faf612fa5011"},"method":"get","type":"path","servers":["a768f050-c5b4-4ea7-8d39-6bdbe0c0c89a"],"path":"/projects/{project_id}","baseUrlOptions":["https://descriptapi.com/v1"],"title":"Get project details","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"031982ca-7b60-4808-9997-3a5c7352ac42":{"in":"path","name":"project_id","description":"The project UUID","required":true,"schema":{"type":"string","format":"uuid","isRequired":true,"description":"The project UUID","uniqueKey":"","typeLabel":"string\u003cuuid>"}}},"responses":{"0b2e0191-37d2-48c4-826a-b224fd437ab6":{"description":"Project details retrieved successfully","content":{"application/json":{"schema":{"type":"object","required":["id","name","drive_id","created_at","updated_at","media_files","compositions","publishes"],"properties":{"id":{"type":"string","format":"uuid","description":"Project ID","isRequired":true,"uniqueKey":"id","typeLabel":"string\u003cuuid>"},"name":{"type":"string","description":"Project name","isRequired":true,"uniqueKey":"name","typeLabel":"string"},"drive_id":{"type":"string","format":"uuid","description":"Drive ID the project belongs to","isRequired":true,"uniqueKey":"drive_id","typeLabel":"string\u003cuuid>"},"created_at":{"type":"string","format":"date-time","description":"When the project was created (ISO 8601)","isRequired":true,"uniqueKey":"created_at","typeLabel":"string\u003cdate-time>"},"updated_at":{"type":"string","format":"date-time","description":"When the project was last updated (ISO 8601)","isRequired":true,"uniqueKey":"updated_at","typeLabel":"string\u003cdate-time>"},"media_files":{"type":"object","description":"Map of display path to media file info","additionalProperties":{"type":"object","required":["type"],"properties":{"type":{"type":"string","enum":["audio","video","image","sequence","other"],"description":"Media type","isRequired":true,"uniqueKey":"media_files.additionalProperties.type","typeLabel":"enum\u003cstring>"},"duration":{"type":"number","format":"float","description":"Duration in seconds (absent for images)","uniqueKey":"media_files.additionalProperties.duration","typeLabel":"number\u003cfloat>"}},"uniqueKey":"media_files.additionalProperties","typeLabel":"object"},"isRequired":true,"uniqueKey":"media_files","typeLabel":"object"},"compositions":{"type":"array","description":"Compositions in the project","items":{"type":"object","required":["id","name"],"properties":{"id":{"type":"string","format":"uuid","description":"Composition ID","isRequired":true,"uniqueKey":"compositions.items.[INDEX].id","typeLabel":"string\u003cuuid>"},"name":{"type":"string","description":"Composition name","isRequired":true,"uniqueKey":"compositions.items.[INDEX].name","typeLabel":"string"},"duration":{"type":"number","format":"float","description":"Duration in seconds","uniqueKey":"compositions.items.[INDEX].duration","typeLabel":"number\u003cfloat>"},"media_type":{"type":"string","description":"Media type of the composition","uniqueKey":"compositions.items.[INDEX].media_type","typeLabel":"string"}},"uniqueKey":"compositions.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"compositions","typeLabel":"object[]"},"publishes":{"type":"array","description":"Successfully published share pages for this project. Each entry represents a composition that has been published and is accessible via its share_url.","items":{"type":"object","required":["share_url","composition_id","access_level","media_type","published_at","updated_at","name"],"properties":{"share_url":{"type":"string","format":"uri","description":"URL of the published share page","example":"https://share.descript.com/view/abc123","isRequired":true,"uniqueKey":"publishes.items.[INDEX].share_url","typeLabel":"string\u003curi>"},"composition_id":{"type":"string","format":"uuid","description":"ID of the composition that was published","isRequired":true,"uniqueKey":"publishes.items.[INDEX].composition_id","typeLabel":"string\u003cuuid>"},"access_level":{"type":"string","enum":["public","unlisted","drive","private","password"],"description":"Access level of the published share page","isRequired":true,"uniqueKey":"publishes.items.[INDEX].access_level","typeLabel":"enum\u003cstring>"},"media_type":{"type":"string","enum":["video","audio","audiogram"],"description":"Media type of the published output","isRequired":true,"uniqueKey":"publishes.items.[INDEX].media_type","typeLabel":"enum\u003cstring>"},"published_at":{"type":"string","format":"date-time","description":"When the publish was created (ISO 8601)","isRequired":true,"uniqueKey":"publishes.items.[INDEX].published_at","typeLabel":"string\u003cdate-time>"},"updated_at":{"type":"string","format":"date-time","description":"When the publish was last updated (ISO 8601)","isRequired":true,"uniqueKey":"publishes.items.[INDEX].updated_at","typeLabel":"string\u003cdate-time>"},"name":{"type":"string","description":"Name of the published share page","isRequired":true,"uniqueKey":"publishes.items.[INDEX].name","typeLabel":"string"}},"uniqueKey":"publishes.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"publishes","typeLabel":"object[]"},"folder_path":{"type":"string","description":"Full folder path for the project (e.g. \"Clients/Acme/Videos\"). Absent when the project is at the drive root.","example":"Clients/Acme/Videos","uniqueKey":"folder_path","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"id":"3c90c3cc-0d44-4b50-8888-8dd25736052a","name":"\u003cstring>","drive_id":"3c90c3cc-0d44-4b50-8888-8dd25736052a","created_at":"2023-11-07T05:31:56Z","updated_at":"2023-11-07T05:31:56Z","media_files":{},"compositions":[{"id":"3c90c3cc-0d44-4b50-8888-8dd25736052a","name":"\u003cstring>","duration":123,"media_type":"\u003cstring>"}],"publishes":[{"share_url":"https://share.descript.com/view/abc123","composition_id":"3c90c3cc-0d44-4b50-8888-8dd25736052a","access_level":"public","media_type":"video","published_at":"2023-11-07T05:31:56Z","updated_at":"2023-11-07T05:31:56Z","name":"\u003cstring>"}],"folder_path":"Clients/Acme/Videos"}}},"exampleType":"generated"}},"exampleType":"generated"},"0d2385df-2668-45bc-8b48-e7425e543f46":{"description":"Bad request - `project_id` is not a valid UUID","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","example":"invalid_input","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"message":{"type":"string","example":"Invalid request body","isRequired":true,"uniqueKey":"message","typeLabel":"string"}},"required":["error","message"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"invalid_input","message":"Invalid request body"}}},"exampleType":"generated"}},"exampleType":"generated"},"761e3595-3ba7-4dee-acf7-7fcc9954dcca":{"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":{"Example":{"title":"Example","value":{"error":"unauthorized","message":"Missing or invalid authentication token"}}},"exampleType":"generated"}},"exampleType":"generated"},"9ce2e127-d759-4e47-b172-c75421957a51":{"description":"Forbidden - user does not have access to this project","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":{"Example":{"title":"Example","value":{"error":"forbidden","message":"User does not have access to this resource"}}},"exampleType":"generated"}},"exampleType":"generated"},"decd54ad-5961-4568-ac9e-7fe145f03a48":{"description":"Project 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":{"Example":{"title":"Example","value":{"error":"not_found","message":"Resource not found"}}},"exampleType":"generated"}},"exampleType":"generated"},"0d888859-e141-4307-852c-faf612fa5011":{"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":{"e3f60dbf-4988-40a6-b18e-e6a86aabc1cc":{"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 project details - Descript Help Center","relatedPagesConfig":{"enabled":true,"limit":5,"mode":"automatic"},"navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-09-24T23:21:12.292Z","originalFileLocation":"developers/api-reference/projects/get-project.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=\"Get a detailed project summary including all media files, compositions, and existing publishes. Returns the project\u0026#x27;s id, name, drive_id, a map of media files (keyed by display path) with type and duration, a list of compositions with id, name, duration, and media type, and a list of successfully published share pages with their URLs, access levels, and publish times. Use this to inspect a project\u0026#x27;s contents before editing or importing media, or to retrieve existing share URLs without triggering a republish.\">\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 project details - Descript Help Center\">\u003cmeta data-mint-head property=\"og:description\" content=\"Get a detailed project summary including all media files, compositions, and existing publishes. Returns the project\u0026#x27;s id, name, drive_id, a map of media files (keyed by display path) with type and duration, a list of compositions with id, name, duration, and media type, and a list of successfully published share pages with their URLs, access levels, and publish times. Use this to inspect a project\u0026#x27;s contents before editing or importing media, or to retrieve existing share URLs without triggering a republish.\">\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/projects/get-project\">\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=Projects\u0026amp;title=Get+project+details\u0026amp;description=Get+a+detailed+project+summary+including+all+media+files%2C+compositions%2C%0Aand+existing+publishes.%0A%0AReturns+the+project%27s+id%2C+name%2C+drive_id%2C+a+map+of+media+files+\u0026amp;theme=f81376d507a7ea740b835510\u0026amp;signature=33fdefe3bbc58572cf663ff261ecbfc73e8c42806c3c90c152409eadcadf6afa\">\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 project details - Descript Help Center\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Get a detailed project summary including all media files, compositions, and existing publishes. Returns the project\u0026#x27;s id, name, drive_id, a map of media files (keyed by display path) with type and duration, a list of compositions with id, name, duration, and media type, and a list of successfully published share pages with their URLs, access levels, and publish times. Use this to inspect a project\u0026#x27;s contents before editing or importing media, or to retrieve existing share URLs without triggering a republish.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://descript-5bf56f3f.mintlify.app/_mintlify/api/og/v2?division=Projects\u0026amp;title=Get+project+details\u0026amp;description=Get+a+detailed+project+summary+including+all+media+files%2C+compositions%2C%0Aand+existing+publishes.%0A%0AReturns+the+project%27s+id%2C+name%2C+drive_id%2C+a+map+of+media+files+\u0026amp;theme=f81376d507a7ea740b835510\u0026amp;signature=33fdefe3bbc58572cf663ff261ecbfc73e8c42806c3c90c152409eadcadf6afa\">\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/projects/get-project\">\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/projects/get-project.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","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","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","description":"List projects accessible to the authenticated user within a drive.\n\nThe drive is determined from the access token.\n\nResults are paginated. Use the `cursor` from the response `pagination.next_cursor`\nto fetch subsequent pages.\n","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","description":"Search the drive tied to the personal API token. Matches project names,\nfolder names, layout pack names, media file names, composition text,\nand transcripts across projects, the drive media library, and Brand\nStudio. On drives with the Enterprise plan, also allows searches for visual matches.\nReturns up to 100 results.\n","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 project details - 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"]}