Return the current verification status for a media item uploaded via the signed upload flow.
Use this to confirm the upload is ready before calling a generation endpoint with media_id.
GET
/
enterprise
/
api
/
get_upload_status
Get signed upload status
curl --request GET \ --url https://api.viddyscribe.com/enterprise/api/get_upload_status \ --header 'X-API-Key: <api-key>'
{
"error": "invalid_input",
"message": "video_id is required"
}
{
"error": "invalid_input",
"message": "video_id is required"
}
{
"error": "invalid_input",
"message": "video_id is required"
}
{
"error": "invalid_input",
"message": "video_id is required"
}
{"docsConfig":{"theme":"almond","$schema":"https://mintlify.com/schema.json","name":"ViddyScribe","colors":{"primary":"#7c3aed","light":"#a78bfa","dark":"#6d28d9"},"logo":{"light":"https://mintcdn.com/viddy/Zm1FgJJxz6d6pLT9/assets/brand/viddyscribe-logo.png?fit=max\u0026auto=format\u0026n=Zm1FgJJxz6d6pLT9\u0026q=85\u0026s=4f653acbcff42a7579402d246e3b0d34","dark":"https://mintcdn.com/viddy/Zm1FgJJxz6d6pLT9/assets/brand/viddyscribe-logo.png?fit=max\u0026auto=format\u0026n=Zm1FgJJxz6d6pLT9\u0026q=85\u0026s=4f653acbcff42a7579402d246e3b0d34","href":"https://docs.viddyscribe.com"},"favicon":"https://mintcdn.com/viddy/Zm1FgJJxz6d6pLT9/assets/brand/favicon.ico?fit=max\u0026auto=format\u0026n=Zm1FgJJxz6d6pLT9\u0026q=85\u0026s=6d73914bda5075dff90303f468607e79","api":{"playground":{}},"background":{},"navbar":{"links":[{"href":"https://viddyscribe.com/dashboard","label":"Dashboard"}]},"footer":{"socials":{"x":"https://x.com/viddyscribe","linkedin":"https://www.linkedin.com/company/viddyscribe","discord":"https://discord.gg/Bkeu3dzksg"},"links":[{"header":"Product","items":[{"label":"Dashboard","href":"https://viddyscribe.com/dashboard"},{"label":"Pricing","href":"https://viddyscribe.com/pricing"},{"label":"Blog","href":"https://viddyscribe.com/blog"}]},{"header":"Help","items":[{"label":"Troubleshooting","href":"/help/troubleshooting"},{"label":"FAQ","href":"/help/faq"},{"label":"Contact support","href":"/help/contact"}]},{"header":"Company","items":[{"label":"Trust Center","href":"https://viddyscribe.com/trust"},{"label":"Privacy","href":"https://viddyscribe.com/privacy"},{"label":"Terms","href":"https://viddyscribe.com/terms"},{"label":"Accessibility","href":"https://viddyscribe.com/accessibility"}]}]},"search":{"prompt":"Search guides and API..."},"fonts":{"family":"Inter"},"contextual":{"options":["copy","view","chatgpt","claude"],"display":"header"},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"viddy","hasAudioNarration":false,"actualSubdomain":"viddy","customDomains":["docs.viddyscribe.com"],"gitSource":{"type":"github","owner":"viddyscribe","repo":"viddyscribe-docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"entitlements":{},"buildId":"6aef986abe4829dd4e3c1272","clientVersion":"0.0.4167","searchFilterCounts":[{"language":"default","tag":"API Reference","count":18},{"language":"default","tag":"Docs","count":17},{"language":"default","tag":"Help \u0026 Resources","count":7},{"language":"default","tag":"Media","count":6},{"language":"default","tag":"Getting Started with the API","count":4},{"language":"default","tag":"API Guides","count":4},{"language":"default","tag":"Processing","count":3},{"language":"default","tag":"Dashboard Guide","count":2},{"language":"default","tag":"Results","count":2},{"language":"default","tag":"Audio Generation","count":1}]},"assistantConfig":{},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","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":"rbac-expansion","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":"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":"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":"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":"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":"editor-metadata","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},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","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}],"googleFontsInlined":false},"customCss":[{"filePath":"style.css","content":"@font-face{font-family:\"ViddyScribe Logo\";src:url(\"/assets/brand/ClashDisplay-Medium.woff2\") format(\"woff2\");font-style:normal;font-weight:500;font-display:swap}a:has(>.nav-logo){display:inline-flex;align-items:center;gap:8px}a>.nav-logo{width:24px;height:22px}a:has(>.nav-logo)::after{content:\"ViddyScribe\" / \"\";font-family:\"ViddyScribe Logo\", sans-serif;font-size:14px;font-weight:500;line-height:20px;letter-spacing:normal;white-space:nowrap;color:#18181b}.dark a:has(>.nav-logo)::after{color:#f4f4f5}#navbar-theme-toggle{display:inline-flex;align-items:center;justify-content:center;flex-shrink:0;width:36px;height:36px;border-radius:8px;color:#52525b;cursor:pointer}#navbar-theme-toggle:hover{background-color:#18181b0d;color:#18181b}#navbar-theme-toggle:focus-visible{outline:2px solid #7c3aed;outline-offset:2px}.dark #navbar-theme-toggle{color:#a1a1aa}.dark #navbar-theme-toggle:hover{background-color:#ffffff0d;color:#f4f4f5}#navbar-theme-toggle .theme-icon-sun,.dark #navbar-theme-toggle .theme-icon-moon{display:none}.dark #navbar-theme-toggle .theme-icon-sun{display:block}body:has(#navbar-theme-toggle) .almond-nav-bottom-section:has(button[aria-label=\"Toggle dark mode\"]){display:none}#search-bar-entry{font-size:12px}#search-bar-entry>div{min-width:0}#search-bar-entry svg{flex-shrink:0}#footer.advanced-footer>div{padding-top:32px;padding-bottom:32px;gap:32px}@media (min-width: 768px){a:has(>.nav-logo)::after{font-size:18px;line-height:28px}}"}],"page":{"pagePath":"api-reference/media/get-upload-status","slug":"/api-reference/media/get-upload-status","pageMetadata":{"openapi":"get /enterprise/api/get_upload_status","title":"Get signed upload status","description":"Return the current verification status for a media item uploaded via the signed upload flow.\nUse this to confirm the upload is ready before calling a generation endpoint with `media_id`.\n","href":"/api-reference/media/get-upload-status"},"description":{"compiledSource":"\"use strict\";\nconst {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(_components.p, {\n children: [\"Return the current verification status for a media item uploaded via the signed upload flow.\\nUse this to confirm the upload is ready before calling a generation endpoint with \", _jsx(_components.code, {\n children: \"media_id\"\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,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={code:`code`,p:`p`,pre:`pre`,span:`span`,..._provideComponents(),...props.components},{CodeBlock,Heading}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Heading)_missingMdxReference(`Heading`,true);return _jsxs(_Fragment,{children:[_jsx(Heading,{level:`2`,id:`usage-example`,children:`Usage Example`}),`\n`,_jsxs(_components.p,{children:[`Poll this endpoint after `,_jsx(_components.code,{children:`notify_upload_complete`}),` until the upload has finished verification and the media is ready for generation.`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`2`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`2`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"https://api.viddyscribe.com/enterprise/api/get_upload_status?media_id=550e8400-e29b-41d4-a716-446655440000\u0026gcs_path=users/user_123/videos/video.mp4\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"X-API-Key: YOUR_API_KEY\"`})]}),`\n`]})})})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"openapi":"get /enterprise/api/get_upload_status","title":"Get signed upload status","description":"Return the current verification status for a media item uploaded via the signed upload flow.\nUse this to confirm the upload is ready before calling a generation endpoint with `media_id`.\n","href":"/api-reference/media/get-upload-status"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Usage Example","slug":"usage-example","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":["/_mintlify/custom/viddy/9236a1c087979a4b/auto-expand-generation-config.js","/_mintlify/custom/viddy/eb43bbd6199a0a86/navbar-theme-toggle.js"],"openApiReferenceData":{"operation":{"summary":"Get signed upload status","description":"Return the current verification status for a media item uploaded via the signed upload flow.\nUse this to confirm the upload is ready before calling a generation endpoint with `media_id`.\n","operationId":"getUploadStatus","tags":["Media"],"parameters":["0e83d5ac-55aa-4583-bcd1-562a99aa7921","1b1c90b8-3606-4e96-9592-90fb15331ccd"],"responses":{"200":"b70ce007-2ddb-4781-85a4-0effd72f13ab","400":"7f2431ad-bfa1-469b-b708-8e2486a23939","404":"cfcd21b2-6f8b-412e-8ba3-e5877d596600","429":"0486e505-f1fb-4e0b-ae81-c19cf4371b10","500":"e17584b0-abac-4ba2-a2bd-6e3ad5e9b153"},"method":"get","type":"path","servers":["611f5187-67f6-4a64-88ef-d72a6eb33f5c"],"security":["04e02328-2a35-4b2c-ad6f-b36ac45e8cda"],"path":"/enterprise/api/get_upload_status","baseUrlOptions":["https://api.viddyscribe.com"],"title":"Get signed upload status","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"0e83d5ac-55aa-4583-bcd1-562a99aa7921":{"name":"media_id","in":"query","required":true,"schema":{"type":"string","format":"uuid","isRequired":true,"description":"Media ID returned by `upload_media`","uniqueKey":"","typeLabel":"string\u003cuuid>"},"description":"Media ID returned by `upload_media`"},"1b1c90b8-3606-4e96-9592-90fb15331ccd":{"name":"gcs_path","in":"query","required":false,"schema":{"type":"string","isRequired":false,"description":"Optional storage path returned by `upload_media`; helps recover the canonical media if deduplication occurred","uniqueKey":"","typeLabel":"string"},"description":"Optional storage path returned by `upload_media`; helps recover the canonical media if deduplication occurred"}},"responses":{"b70ce007-2ddb-4781-85a4-0effd72f13ab":{"description":"Upload status returned successfully","content":{"application/json":{"schema":{"type":"object","properties":{"media_id":{"type":"string","format":"uuid","description":"Original media ID provided by the client","uniqueKey":"media_id","typeLabel":"string\u003cuuid>"},"canonical_media_id":{"type":"string","format":"uuid","description":"Canonical media ID to use for generation","uniqueKey":"canonical_media_id","typeLabel":"string\u003cuuid>"},"upload_status":{"type":"string","description":"Current verification status for the uploaded media","uniqueKey":"upload_status","typeLabel":"string"},"duration_seconds":{"oneOf":[{"type":"number","description":"Video duration in seconds when available","uniqueKey":"duration_seconds.oneOf.0","typeLabel":"number"},{"type":"null","description":"Video duration in seconds when available","uniqueKey":"duration_seconds.oneOf.1","typeLabel":"null"}],"uniqueKey":"duration_seconds","typeLabel":"number | null"},"frame_rate":{"oneOf":[{"type":"number","description":"Video frame rate (fps) when available","uniqueKey":"frame_rate.oneOf.0","typeLabel":"number"},{"type":"null","description":"Video frame rate (fps) when available","uniqueKey":"frame_rate.oneOf.1","typeLabel":"null"}],"uniqueKey":"frame_rate","typeLabel":"number | null"}},"uniqueKey":"","typeLabel":"object"},"example":{"media_id":"550e8400-e29b-41d4-a716-446655440000","canonical_media_id":"550e8400-e29b-41d4-a716-446655440000","upload_status":"completed","duration_seconds":45.5,"frame_rate":30},"examples":{"Example":{"title":"Example","value":{"media_id":"550e8400-e29b-41d4-a716-446655440000","canonical_media_id":"550e8400-e29b-41d4-a716-446655440000","upload_status":"completed","duration_seconds":45.5,"frame_rate":30}}},"exampleType":"examples"}},"exampleType":"examples"},"7f2431ad-bfa1-469b-b708-8e2486a23939":{"description":"Bad request - missing or invalid parameters","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","description":"Primary error field. Many endpoints return a machine-readable value here, while some 409 media-state responses return a human-readable string and place the machine-readable identifier in code","uniqueKey":"error","typeLabel":"string"},"code":{"type":"string","description":"Optional machine-readable identifier for responses that separate the human-readable error text from the stable error code, such as upload_not_ready or upload_failed","uniqueKey":"code","typeLabel":"string"},"upload_status":{"type":"string","description":"Optional media upload status included on media-state conflict responses","uniqueKey":"upload_status","typeLabel":"string"},"message":{"type":"string","description":"Human-readable error message","uniqueKey":"message","typeLabel":"string"},"details":{"type":"string","description":"Optional extra context on a small number of errors, such as the upstream status code when a source URL could not be fetched. Never contains internal diagnostics; server faults return error and message only","uniqueKey":"details","typeLabel":"string"}},"example":{"error":"invalid_input","message":"video_id is required"},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"invalid_input","message":"video_id is required"}}},"exampleType":"generated"}},"exampleType":"generated"},"cfcd21b2-6f8b-412e-8ba3-e5877d596600":{"description":"Media not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","description":"Primary error field. Many endpoints return a machine-readable value here, while some 409 media-state responses return a human-readable string and place the machine-readable identifier in code","uniqueKey":"error","typeLabel":"string"},"code":{"type":"string","description":"Optional machine-readable identifier for responses that separate the human-readable error text from the stable error code, such as upload_not_ready or upload_failed","uniqueKey":"code","typeLabel":"string"},"upload_status":{"type":"string","description":"Optional media upload status included on media-state conflict responses","uniqueKey":"upload_status","typeLabel":"string"},"message":{"type":"string","description":"Human-readable error message","uniqueKey":"message","typeLabel":"string"},"details":{"type":"string","description":"Optional extra context on a small number of errors, such as the upstream status code when a source URL could not be fetched. Never contains internal diagnostics; server faults return error and message only","uniqueKey":"details","typeLabel":"string"}},"example":{"error":"invalid_input","message":"video_id is required"},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"invalid_input","message":"video_id is required"}}},"exampleType":"generated"}},"exampleType":"generated"},"0486e505-f1fb-4e0b-ae81-c19cf4371b10":{"description":"Too many requests","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","description":"Primary error field. Many endpoints return a machine-readable value here, while some 409 media-state responses return a human-readable string and place the machine-readable identifier in code","uniqueKey":"error","typeLabel":"string"},"code":{"type":"string","description":"Optional machine-readable identifier for responses that separate the human-readable error text from the stable error code, such as upload_not_ready or upload_failed","uniqueKey":"code","typeLabel":"string"},"upload_status":{"type":"string","description":"Optional media upload status included on media-state conflict responses","uniqueKey":"upload_status","typeLabel":"string"},"message":{"type":"string","description":"Human-readable error message","uniqueKey":"message","typeLabel":"string"},"details":{"type":"string","description":"Optional extra context on a small number of errors, such as the upstream status code when a source URL could not be fetched. Never contains internal diagnostics; server faults return error and message only","uniqueKey":"details","typeLabel":"string"}},"example":{"error":"invalid_input","message":"video_id is required"},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"invalid_input","message":"video_id is required"}}},"exampleType":"generated"}},"exampleType":"generated"},"e17584b0-abac-4ba2-a2bd-6e3ad5e9b153":{"description":"Internal server error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","description":"Primary error field. Many endpoints return a machine-readable value here, while some 409 media-state responses return a human-readable string and place the machine-readable identifier in code","uniqueKey":"error","typeLabel":"string"},"code":{"type":"string","description":"Optional machine-readable identifier for responses that separate the human-readable error text from the stable error code, such as upload_not_ready or upload_failed","uniqueKey":"code","typeLabel":"string"},"upload_status":{"type":"string","description":"Optional media upload status included on media-state conflict responses","uniqueKey":"upload_status","typeLabel":"string"},"message":{"type":"string","description":"Human-readable error message","uniqueKey":"message","typeLabel":"string"},"details":{"type":"string","description":"Optional extra context on a small number of errors, such as the upstream status code when a source URL could not be fetched. Never contains internal diagnostics; server faults return error and message only","uniqueKey":"details","typeLabel":"string"}},"example":{"error":"invalid_input","message":"video_id is required"},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"invalid_input","message":"video_id is required"}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"04e02328-2a35-4b2c-ad6f-b36ac45e8cda":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"X-API-Key","description":"API key for authentication. Obtain from your team admin.\n\nExample: `X-API-Key: vsk_abc123def456ghi789jkl012mno345pqr678stu901vwx234yz`\n","scopes":[]}}},"servers":{"611f5187-67f6-4a64-88ef-d72a6eb33f5c":{"url":"https://api.viddyscribe.com","description":"Production server"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"apiKey","in":"header","name":"X-API-Key","description":"API key for authentication. Obtain from your team admin.\n\nExample: `X-API-Key: vsk_abc123def456ghi789jkl012mno345pqr678stu901vwx234yz`\n","scopes":[]},"schema":{"title":"X-API-Key","type":"string","description":"API key for authentication. Obtain from your team admin.\n\nExample: `X-API-Key: vsk_abc123def456ghi789jkl012mno345pqr678stu901vwx234yz`\n","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"ApiKeyAuth","name":"X-API-Key"}],"title":"ApiKeyAuth"}]},"originalFileLocation":"openapi.yaml"},"subdomain":"viddy","siteName":"ViddyScribe","title":"Get signed upload status - ViddyScribe","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-04-25T15:07:43.298Z","originalFileLocation":"api-reference/media/get-upload-status.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=\"Return the current verification status for a media item uploaded via the signed upload flow. Use this to confirm the upload is ready before calling a generation endpoint with media_id.\">\u003cmeta data-mint-head name=\"application-name\" content=\"ViddyScribe\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/viddy/xY1Vd1FPSczfyB53/_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/viddy/xY1Vd1FPSczfyB53/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/viddy/xY1Vd1FPSczfyB53/_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/viddy/xY1Vd1FPSczfyB53/_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/viddy/xY1Vd1FPSczfyB53/_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/viddy/xY1Vd1FPSczfyB53/_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/viddy/xY1Vd1FPSczfyB53/_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/viddy/xY1Vd1FPSczfyB53/_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/viddy/xY1Vd1FPSczfyB53/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Get signed upload status - ViddyScribe\">\u003cmeta data-mint-head property=\"og:description\" content=\"Return the current verification status for a media item uploaded via the signed upload flow. Use this to confirm the upload is ready before calling a generation endpoint with media_id.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"ViddyScribe\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.viddyscribe.com/api-reference/media/get-upload-status\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://viddy.mintlify.site/_mintlify/api/og/v2?division=Media\u0026amp;title=Get+signed+upload+status\u0026amp;description=Return+the+current+verification+status+for+a+media+item+uploaded+via+the+signed+upload+flow.%0AUse+this+to+confirm+the+upload+is+ready+before+calling+a+generation\u0026amp;theme=bdc91e301366307ce90d181c\u0026amp;signature=bb0ff41636bfc5381e05820ecacc892f0526eb09ae8ba01df282655fe39c679c\">\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 signed upload status - ViddyScribe\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Return the current verification status for a media item uploaded via the signed upload flow. Use this to confirm the upload is ready before calling a generation endpoint with media_id.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://viddy.mintlify.site/_mintlify/api/og/v2?division=Media\u0026amp;title=Get+signed+upload+status\u0026amp;description=Return+the+current+verification+status+for+a+media+item+uploaded+via+the+signed+upload+flow.%0AUse+this+to+confirm+the+upload+is+ready+before+calling+a+generation\u0026amp;theme=bdc91e301366307ce90d181c\u0026amp;signature=bb0ff41636bfc5381e05820ecacc892f0526eb09ae8ba01df282655fe39c679c\">\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/viddy/xY1Vd1FPSczfyB53/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"ViddyScribe\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#7c3aed\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.viddyscribe.com/api-reference/media/get-upload-status\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/media/get-upload-status.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.viddyscribe.com/#organization\",\"name\":\"ViddyScribe\",\"url\":\"https://docs.viddyscribe.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/viddy/Zm1FgJJxz6d6pLT9/assets/brand/viddyscribe-logo.png?fit=max\u0026auto=format\u0026n=Zm1FgJJxz6d6pLT9\u0026q=85\u0026s=4f653acbcff42a7579402d246e3b0d34\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.viddyscribe.com#website\",\"name\":\"ViddyScribe\",\"url\":\"https://docs.viddyscribe.com\",\"publisher\":{\"@id\":\"https://docs.viddyscribe.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.viddyscribe.com/api-reference/media/get-upload-status#webpage\",\"url\":\"https://docs.viddyscribe.com/api-reference/media/get-upload-status\",\"name\":\"Get signed upload status\",\"description\":\"Return the current verification status for a media item uploaded via the signed upload flow. Use this to confirm the upload is ready before calling a generation endpoint with media_id.\",\"dateModified\":\"2026-04-25T15:07:43.298Z\",\"isPartOf\":{\"@id\":\"https://docs.viddyscribe.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.viddyscribe.com/api-reference/media/get-upload-status#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.viddyscribe.com/api-reference/media/get-upload-status#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Media\",\"item\":\"https://docs.viddyscribe.com/api-reference/media/upload-media\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Get signed upload status\",\"item\":\"https://docs.viddyscribe.com/api-reference/media/get-upload-status\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.viddyscribe.com/api-reference/media/get-upload-status#apireference\",\"headline\":\"Get signed upload status\",\"name\":\"Get signed upload status\",\"description\":\"Return the current verification status for a media item uploaded via the signed upload flow. Use this to confirm the upload is ready before calling a generation endpoint with media_id.\",\"url\":\"https://docs.viddyscribe.com/api-reference/media/get-upload-status\",\"mainEntityOfPage\":{\"@id\":\"https://docs.viddyscribe.com/api-reference/media/get-upload-status#webpage\"},\"dateModified\":\"2026-04-25T15:07:43.298Z\",\"publisher\":{\"@id\":\"https://docs.viddyscribe.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.viddyscribe.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"ViddyScribe\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"ViddyScribe\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/api-reference/media/get-upload-status.md","siteName":"ViddyScribe","nav":{"global":null,"tabs":[{"tab":"Docs","pages":[{"title":"Docs","href":"/introduction"}]},{"tab":"API Reference","groups":[{"group":"API Reference","pages":[{"title":"API Reference","icon":"code","href":"/api-reference/overview"},{"title":"Languages and Voices","sidebarTitle":"Languages and Voices","icon":"microphone","href":"/api-reference/voices"}]},{"group":"Media","pages":[{"openapi":"post /enterprise/api/upload_media","title":"Upload media file or URL","href":"/api-reference/media/upload-media"},{"openapi":"post /enterprise/api/notify_upload_complete","title":"Notify signed upload complete","description":"Signal that the client has finished uploading bytes to a signed upload URL returned by `/enterprise/api/upload_media`.\nThis starts asynchronous verification so the media can be used for generation.\n","href":"/api-reference/media/notify-upload-complete"},{"openapi":"get /enterprise/api/get_upload_status","title":"Get signed upload status","href":"/api-reference/media/get-upload-status"}]},{"group":"Text Generation","pages":[{"title":"Generate AD Text","sidebarTitle":"Generate AD Text","openapi":"post /enterprise/api/generate_ad_text","description":"Generate Audio Description text (VTT, JSON, etc.) for a video.\nSupports Input via `media_id`, `url`, or direct `file` upload.\nReturns a job_id for tracking progress.\n","href":"/api-reference/processing/generate-audio-description-text"}]},{"group":"Audio Generation","pages":[{"title":"Generate AD Audio","sidebarTitle":"Generate AD Audio","openapi":"post /enterprise/api/generate_ad_audio","href":"/api-reference/processing/generate-audio-description-audio"}]},{"group":"Video Generation","pages":[{"title":"Generate AD Video","sidebarTitle":"Generate AD Video","openapi":"post /enterprise/api/generate_ad_video","href":"/api-reference/processing/generate-audio-description-video"}]},{"group":"Results","pages":[{"title":"Get job results","deprecated":null,"version":null,"openapi":"/openapi.yaml get /enterprise/api/get_results","href":"/api-reference/results/get-job-results"}]},{"group":"Media","pages":[{"title":"Upload media file or URL","deprecated":null,"version":null,"openapi":"/openapi.yaml post /enterprise/api/upload_media","href":"/api-reference/media/upload-media-file-or-url"},{"title":"Notify signed upload complete","deprecated":null,"version":null,"openapi":"/openapi.yaml post /enterprise/api/notify_upload_complete","href":"/api-reference/media/notify-signed-upload-complete"},{"title":"Get signed upload status","deprecated":null,"version":null,"openapi":"/openapi.yaml get /enterprise/api/get_upload_status","href":"/api-reference/media/get-signed-upload-status"}]},{"group":"Processing","pages":[{"title":"Generate AD text","deprecated":null,"version":null,"openapi":"/openapi.yaml post /enterprise/api/generate_ad_text","href":"/api-reference/processing/generate-ad-text"},{"title":"Generate AD video","deprecated":null,"version":null,"openapi":"/openapi.yaml post /enterprise/api/generate_ad_video","href":"/api-reference/processing/generate-ad-video"},{"title":"Generate AD audio","deprecated":null,"version":null,"openapi":"/openapi.yaml post /enterprise/api/generate_ad_audio","href":"/api-reference/processing/generate-ad-audio"}]},{"group":"Results","pages":[{"title":"Get job results","deprecated":null,"version":null,"openapi":"/openapi.yaml get /enterprise/api/get_results","href":"/api-reference/results/get-job-results"},{"title":"Delete a generation job","deprecated":null,"version":null,"openapi":"/openapi.yaml delete /enterprise/api/jobs/{job_id}","href":"/api-reference/results/delete-a-generation-job"}]}]}]},"basePath":"","title":"Get signed upload status - ViddyScribe","buildId":"dpl_9RFrWkXdFTJCytfx6jAofvAaEXr6","deploymentId":"dpl_9RFrWkXdFTJCytfx6jAofvAaEXr6","dynamics":["c2aa737661","b0f84f53ff","a9bb46feb3","2b790eda92"],"chunks":["OpenApiReferenceProvider-BgGj2PGS.js","utils-BhNOqRKb.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-BAgRNUZo.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-CGkb0TPw.js","snippetPresets-ChLkL1a6.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","Page-C7x-eUfk.js","ApiExamples-Ef10Jrbx.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-DlVCnjU8.js","shallow-BA55zJxQ.js","getApiPlaygroundDisplay-DR09dKtp.js","CodeSnippet-BZ8J8Kll.js","CodeSnippets-CcguVheG.js","getPastedJson-D5UqeqBp.js","icon-DpD0l99C.js","MethodPill-Wg2NXsp_.js","DuplicateIcon-CCSyX8lh.js","createIcon-C4Ukv9HX.js","DynamicMarkdown-RhjEuCHC.js","SectionHeading-DL1MykRq.js","axios-vUo_bRtp.js","Markdown-BwQ4RMdp.js","dist-CiVXVcSh.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","katex-YMM-FMeD.js","html-void-elements-mCSPHezU.js","marked.esm-CZWythHk.js","AssistantPageLink-Dic2Jtb2.js"]}