Step 1 of 2 for transcribing your own audio or video file. Returns a pre-signed S3 URL to PUT the raw file to; the URL is valid for one hour. Then call /api/transcribeFile with the returned key.
Step 1 of 2 for transcribing your own audio or video file. Returns a pre-signed S3 URL you PUT the raw file to. The URL is valid for one hour.After the upload finishes, call Transcribe File with the returned key.
Request
Field
Type
Required
Description
fileName
string
yes
Original filename, including extension (e.g. meeting.m4a).
fileType
string
yes
MIME type of the file (e.g. audio/mp4, audio/mpeg, video/mp4). Must match the Content-Type header of your PUT.
# 1. Ask for an upload URLRESP=$(curl -s -X POST https://api.transcribetube.com/api/upload-url \ -H "api-key: $TRANSCRIBETUBE_API_KEY" \ -H "Content-Type: application/json" \ -d '{"fileName": "meeting.m4a", "fileType": "audio/mp4"}')URL=$(echo "$RESP" | jq -r .url)KEY=$(echo "$RESP" | jq -r .key)# 2. Upload the file straight to S3 (no api-key header here)curl -X PUT "$URL" -H "Content-Type: audio/mp4" --data-binary @meeting.m4a
Supported containers: anything ffmpeg can read — m4a, mp3, wav, caf, flac, mp4, mov, … Video files are converted to audio server-side.
Authorizations
api-key
string
header
required
Body
application/json
fileName
string
required
Original filename including extension
Example:
"meeting.m4a"
fileType
string
required
MIME type; must match the Content-Type of the PUT
Example:
"audio/mp4"
Response
Pre-signed upload URL
url
string
Pre-signed S3 PUT URL
key
string
Object key to pass to /api/transcribeFile
Example:
"raw/usr/9d2e/4f1c/meeting.m4a"
{"docsConfig":{"$schema":"https://mintlify.com/docs.json","theme":"mint","name":"TranscribeTube","colors":{"primary":"#ef3d3d","light":"#e61313","dark":"#ef3d3d"},"favicon":"https://mintcdn.com/transcrubetube/Tj9bW3sAQ04_tPht/logo/android-chrome-512x512.png?fit=max\u0026auto=format\u0026n=Tj9bW3sAQ04_tPht\u0026q=85\u0026s=4bdd53cce69d6128c2041a106cc9be9e","logo":{"light":"https://mintcdn.com/transcrubetube/Tj9bW3sAQ04_tPht/logo/light.png?fit=max\u0026auto=format\u0026n=Tj9bW3sAQ04_tPht\u0026q=85\u0026s=7b76cefb366db48fc972102ce621990e","dark":"https://mintcdn.com/transcrubetube/Tj9bW3sAQ04_tPht/logo/black.png?fit=max\u0026auto=format\u0026n=Tj9bW3sAQ04_tPht\u0026q=85\u0026s=5223cd45619e005549f8ce6f20d07efb"},"navbar":{"links":[{"label":"Support","href":"mailto:hello@transcribetube.com"}],"primary":{"type":"button","label":"Dashboard","href":"https://app.transcribetube.com"}},"footer":{"socials":{"x":"https://x.com/TranscribeTube","youtube":"https://www.youtube.com/@TranscribeTube"}},"integrations":{"posthog":{"apiKey":"phc_PhdIMJD2O6TARtAbDfTynwiuAeZBkHaNhDCMiGnRzf6"}},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"transcrubetube","hasAudioNarration":false,"actualSubdomain":"transcrubetube","customDomains":["docs.transcribetube.com"],"gitSource":{"type":"github","owner":"hicay","repo":"transcribetube","deployBranch":"main","contentDirectory":"docs","isPrivate":true,"mountPath":"","label":""},"entitlements":{},"buildId":"6b01d23e7f4e51979dfe3170","clientVersion":"0.0.4270","searchFilterCounts":[{"language":"default","tag":"API Documentation","count":19},{"language":"default","tag":"Get Started","count":12},{"language":"default","tag":"Documentation","count":6},{"language":"default","tag":"Transcription","count":3},{"language":"default","tag":"Project ","count":2}]},"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":"site-roles","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":"starter-pricing","enabled":true,"variant":{"name":"treatment","enabled":true,"payload":{"type":"string","value":"treatment"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[]}
{"page":{"pagePath":"api-documentation/endpoint/post-apiuploadurl","slug":"/api-documentation/endpoint/post-apiuploadurl","pageMetadata":{"title":"Get Upload URL","openapi":"post /api/upload-url","description":"Step 1 of 2 for transcribing your own audio or video file. Returns a pre-signed S3 URL to PUT the raw file to; the URL is valid for one hour. Then call /api/transcribeFile with the returned key.","href":"/api-documentation/endpoint/post-apiuploadurl"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Step 1 of 2 for transcribing your own audio or video file. Returns a pre-signed S3 URL to PUT the raw file to; the URL is valid for one hour. Then call /api/transcribeFile with the returned key.\"\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={a:`a`,code:`code`,p:`p`,pre:`pre`,span:`span`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,..._provideComponents(),...props.components},{CodeBlock,CodeGroup,Heading,Note,Table}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!CodeGroup)_missingMdxReference(`CodeGroup`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Note)_missingMdxReference(`Note`,true);if(!Table)_missingMdxReference(`Table`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`Step 1 of 2 for transcribing your own audio or video file. Returns a pre-signed S3 URL you `,_jsx(_components.code,{children:`PUT`}),` the raw file to. The URL is valid for one hour.`]}),`\n`,_jsxs(_components.p,{children:[`After the upload finishes, call `,_jsx(_components.a,{href:`/api-documentation/endpoint/post-apitranscribefile`,children:`Transcribe File`}),` with the returned `,_jsx(_components.code,{children:`key`}),`.`]}),`\n`,_jsx(Heading,{level:`2`,id:`request`,children:`Request`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Field`}),_jsx(_components.th,{children:`Type`}),_jsx(_components.th,{children:`Required`}),_jsx(_components.th,{children:`Description`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`fileName`})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{children:`yes`}),_jsxs(_components.td,{children:[`Original filename, including extension (e.g. `,_jsx(_components.code,{children:`meeting.m4a`}),`).`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`fileType`})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{children:`yes`}),_jsxs(_components.td,{children:[`MIME type of the file (e.g. `,_jsx(_components.code,{children:`audio/mp4`}),`, `,_jsx(_components.code,{children:`audio/mpeg`}),`, `,_jsx(_components.code,{children:`video/mp4`}),`). Must match the `,_jsx(_components.code,{children:`Content-Type`}),` header of your `,_jsx(_components.code,{children:`PUT`}),`.`]})]})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`response`,children:`Response`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`4`,language:`json`,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:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`4`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"url\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"https://videoven-data.s3.amazonaws.com/raw/usr/…?X-Amz-Signature=…\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"key\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"raw/usr/9d2e…/4f1c…/meeting.m4a\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),`\n`,_jsx(Heading,{level:`2`,id:`example`,children:`Example`}),`\n`,_jsx(CodeGroup,{children:_jsx(CodeBlock,{filename:`cURL`,numberOfLines:`10`,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:`10`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:`# 1. Ask for an upload URL`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`RESP`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`$(`}),_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -s`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -X`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` POST`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` https://api.transcribetube.com/api/upload-url`}),_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:` \"api-key: `}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`$TRANSCRIBETUBE_API_KEY`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"`}),_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:` \"Content-Type: application/json\"`}),_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:` -d`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` '{\"fileName\": \"meeting.m4a\", \"fileType\": \"audio/mp4\"}'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`)`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`URL`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`$(`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#DCDCAA`},children:`echo`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`$RESP`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` |`}),_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:` jq`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -r`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` .url`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`)`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`KEY`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`$(`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#DCDCAA`},children:`echo`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`$RESP`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` |`}),_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:` jq`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -r`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` .key`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`)`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:`# 2. Upload the file straight to S3 (no api-key header here)`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -X`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` PUT`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`$URL`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Content-Type: audio/mp4\"`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --data-binary`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` @meeting.m4a`})]}),`\n`]})})})}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[`Supported containers: anything ffmpeg can read — `,_jsx(_components.code,{children:`m4a`}),`, `,_jsx(_components.code,{children:`mp3`}),`, `,_jsx(_components.code,{children:`wav`}),`, `,_jsx(_components.code,{children:`caf`}),`, `,_jsx(_components.code,{children:`flac`}),`, `,_jsx(_components.code,{children:`mp4`}),`, `,_jsx(_components.code,{children:`mov`}),`, … Video files are converted to audio server-side.`]})})]})}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":{"title":"Get Upload URL","openapi":"post /api/upload-url","description":"Step 1 of 2 for transcribing your own audio or video file. Returns a pre-signed S3 URL to PUT the raw file to; the URL is valid for one hour. Then call /api/transcribeFile with the returned key.","href":"/api-documentation/endpoint/post-apiuploadurl"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Request","slug":"request","depth":2,"children":[]},{"title":"Response","slug":"response","depth":2,"children":[]},{"title":"Example","slug":"example","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"operationId":"ApiController_createUploadUrl","summary":"","description":"Step 1 of 2 for transcribing your own audio or video file. Returns a pre-signed S3 URL to PUT the raw file to; the URL is valid for one hour. Then call /api/transcribeFile with the returned key.","parameters":[],"requestBody":"62a6d1a2-0bac-4166-896c-1c9f8ce4c71c","responses":{"201":"b387d5dd-a68e-408b-9b48-af2b4cf68b8e","400":"ae0d3bab-7648-40ae-b447-9a0e483bdc1f","401":"3480c974-8e49-4ba0-8453-51bbd4710369"},"tags":["Api"],"security":["fc6530ba-61af-42c1-a037-2654311b6776"],"method":"post","type":"path","servers":["e882ec6d-d136-4cbe-a615-70bd92854929"],"path":"/api/upload-url","baseUrlOptions":["https://api.transcribetube.com"],"title":"","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["fileName","fileType"],"properties":{"fileName":{"type":"string","description":"Original filename including extension","example":"meeting.m4a","isRequired":true,"uniqueKey":"fileName","typeLabel":"string"},"fileType":{"type":"string","description":"MIME type; must match the Content-Type of the PUT","example":"audio/mp4","isRequired":true,"uniqueKey":"fileType","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"fileName":"meeting.m4a","fileType":"audio/mp4"}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"b387d5dd-a68e-408b-9b48-af2b4cf68b8e":{"description":"Pre-signed upload URL","content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string","description":"Pre-signed S3 PUT URL","uniqueKey":"url","typeLabel":"string"},"key":{"type":"string","description":"Object key to pass to /api/transcribeFile","example":"raw/usr/9d2e/4f1c/meeting.m4a","uniqueKey":"key","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"url":"\u003cstring>","key":"raw/usr/9d2e/4f1c/meeting.m4a"}}},"exampleType":"generated"}},"exampleType":"generated"},"ae0d3bab-7648-40ae-b447-9a0e483bdc1f":{"description":"Validation error","content":{"application/json":{"schema":{"type":"object","properties":{"statusCode":{"type":"integer","uniqueKey":"statusCode","typeLabel":"integer"},"message":{"type":"string","uniqueKey":"message","typeLabel":"string"},"error":{"type":"string","uniqueKey":"error","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"statusCode":123,"message":"\u003cstring>","error":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"3480c974-8e49-4ba0-8453-51bbd4710369":{"description":"Missing or invalid api-key","content":{"application/json":{"schema":{"type":"object","properties":{"statusCode":{"type":"integer","uniqueKey":"statusCode","typeLabel":"integer"},"message":{"type":"string","uniqueKey":"message","typeLabel":"string"},"error":{"type":"string","uniqueKey":"error","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"statusCode":123,"message":"\u003cstring>","error":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"fc6530ba-61af-42c1-a037-2654311b6776":{"api-key":{"type":"apiKey","in":"header","name":"api-key","scopes":[],"schemeName":"api-key"}}},"servers":{"e882ec6d-d136-4cbe-a615-70bd92854929":{"url":"https://api.transcribetube.com"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"apiKey","in":"header","name":"api-key","scopes":[],"schemeName":"api-key"},"schema":{"title":"api-key","type":"string","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"api-key","name":"api-key"}],"title":"api-key"}]},"originalFileLocation":"swagger.json"},"subdomain":"transcrubetube","siteName":"TranscribeTube","title":"Get Upload URL - TranscribeTube","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-21T17:17:55.143Z","originalFileLocation":"api-documentation/endpoint/post-apiuploadurl.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=\"Step 1 of 2 for transcribing your own audio or video file. Returns a pre-signed S3 URL to PUT the raw file to; the URL is valid for one hour. Then call /api/transcribeFile with the returned key.\">\u003cmeta data-mint-head name=\"application-name\" content=\"TranscribeTube\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/transcrubetube/kib0clFuIx-UznoX/_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/transcrubetube/kib0clFuIx-UznoX/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/transcrubetube/kib0clFuIx-UznoX/_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/transcrubetube/kib0clFuIx-UznoX/_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/transcrubetube/kib0clFuIx-UznoX/_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/transcrubetube/kib0clFuIx-UznoX/_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/transcrubetube/kib0clFuIx-UznoX/_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/transcrubetube/kib0clFuIx-UznoX/_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/transcrubetube/kib0clFuIx-UznoX/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Get Upload URL - TranscribeTube\">\u003cmeta data-mint-head property=\"og:description\" content=\"Step 1 of 2 for transcribing your own audio or video file. Returns a pre-signed S3 URL to PUT the raw file to; the URL is valid for one hour. Then call /api/transcribeFile with the returned key.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"TranscribeTube\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.transcribetube.com/api-documentation/endpoint/post-apiuploadurl\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://transcrubetube.mintlify.site/_mintlify/api/og/v2?division=Transcription\u0026amp;title=Get+Upload+URL\u0026amp;description=Step+1+of+2+for+transcribing+your+own+audio+or+video+file.+Returns+a+pre-signed+S3+URL+to+PUT+the+raw+file+to%3B+the+URL+is+valid+for+one+hour.+Then+call+%2Fapi%2Ftra\u0026amp;theme=0327c594704cbcf0a3f9c7ea\u0026amp;signature=458f2ec4a7ada23d52bd31e6b96ee23c07df7b0702420969c4c99fe467fcc43a\">\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 Upload URL - TranscribeTube\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Step 1 of 2 for transcribing your own audio or video file. Returns a pre-signed S3 URL to PUT the raw file to; the URL is valid for one hour. Then call /api/transcribeFile with the returned key.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://transcrubetube.mintlify.site/_mintlify/api/og/v2?division=Transcription\u0026amp;title=Get+Upload+URL\u0026amp;description=Step+1+of+2+for+transcribing+your+own+audio+or+video+file.+Returns+a+pre-signed+S3+URL+to+PUT+the+raw+file+to%3B+the+URL+is+valid+for+one+hour.+Then+call+%2Fapi%2Ftra\u0026amp;theme=0327c594704cbcf0a3f9c7ea\u0026amp;signature=458f2ec4a7ada23d52bd31e6b96ee23c07df7b0702420969c4c99fe467fcc43a\">\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/transcrubetube/kib0clFuIx-UznoX/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"TranscribeTube\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#ef3d3d\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.transcribetube.com/api-documentation/endpoint/post-apiuploadurl\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-documentation/endpoint/post-apiuploadurl.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.transcribetube.com/#organization\",\"name\":\"TranscribeTube\",\"url\":\"https://docs.transcribetube.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/transcrubetube/Tj9bW3sAQ04_tPht/logo/light.png?fit=max\u0026auto=format\u0026n=Tj9bW3sAQ04_tPht\u0026q=85\u0026s=7b76cefb366db48fc972102ce621990e\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.transcribetube.com#website\",\"name\":\"TranscribeTube\",\"url\":\"https://docs.transcribetube.com\",\"publisher\":{\"@id\":\"https://docs.transcribetube.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.transcribetube.com/api-documentation/endpoint/post-apiuploadurl#webpage\",\"url\":\"https://docs.transcribetube.com/api-documentation/endpoint/post-apiuploadurl\",\"name\":\"Get Upload URL\",\"description\":\"Step 1 of 2 for transcribing your own audio or video file. Returns a pre-signed S3 URL to PUT the raw file to; the URL is valid for one hour. Then call /api/transcribeFile with the returned key.\",\"dateModified\":\"2026-11-21T17:17:55.143Z\",\"isPartOf\":{\"@id\":\"https://docs.transcribetube.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.transcribetube.com/api-documentation/endpoint/post-apiuploadurl#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.transcribetube.com/api-documentation/endpoint/post-apiuploadurl#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Transcription\",\"item\":\"https://docs.transcribetube.com/api-documentation/endpoint/post-apitranscribevideo\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Get Upload URL\",\"item\":\"https://docs.transcribetube.com/api-documentation/endpoint/post-apiuploadurl\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.transcribetube.com/api-documentation/endpoint/post-apiuploadurl#apireference\",\"headline\":\"Get Upload URL\",\"name\":\"Get Upload URL\",\"description\":\"Step 1 of 2 for transcribing your own audio or video file. Returns a pre-signed S3 URL to PUT the raw file to; the URL is valid for one hour. Then call /api/transcribeFile with the returned key.\",\"url\":\"https://docs.transcribetube.com/api-documentation/endpoint/post-apiuploadurl\",\"mainEntityOfPage\":{\"@id\":\"https://docs.transcribetube.com/api-documentation/endpoint/post-apiuploadurl#webpage\"},\"dateModified\":\"2026-11-21T17:17:55.143Z\",\"publisher\":{\"@id\":\"https://docs.transcribetube.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.transcribetube.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"TranscribeTube\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"TranscribeTube\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/api-documentation/endpoint/post-apiuploadurl.md","siteName":"TranscribeTube","nav":{"global":null,"tabs":[{"tab":"Documentation","pages":[{"title":"Documentation","href":"/introduction"}]},{"tab":"API Documentation","anchors":[{"anchor":"API Documentation","icon":"code","groups":[{"group":"API Documentation","pages":[{"title":"Getting Started","href":"/api-documentation/introduction"},{"title":"Get your API key","href":"/api-documentation/authentication"},{"title":"Lifecycle \u0026 Polling","href":"/api-documentation/lifecycle"},{"title":"Webhooks","href":"/api-documentation/webhooks"}]},{"group":"Transcription","pages":[{"title":"Transcribe YouTube Video","openapi":"post /api/transcribeVideo","description":"This API endpoint allows users to submit a YouTube video ID along with language preference and a webhook URL. Upon submission, the system processes the request and sends a POST request to the provided webhook URL with project details with transcription.","href":"/api-documentation/endpoint/post-apitranscribevideo"},{"title":"Get Upload URL","openapi":"post /api/upload-url","href":"/api-documentation/endpoint/post-apiuploadurl"},{"title":"Transcribe File","openapi":"post /api/transcribeFile","description":"Step 2 of 2 for transcribing your own file. Registers the object uploaded via /api/upload-url as a project and starts processing. Poll /api/detail/{id} or pass a webhookUrl.","href":"/api-documentation/endpoint/post-apitranscribefile"}]},{"group":"Project ","pages":[{"title":"List Projects","openapi":"get /api/list","href":"/api-documentation/endpoint/get-apilist"},{"title":"Get Project Detail","openapi":"get /api/detail/{id}","href":"/api-documentation/endpoint/get-apidetail"}]}]}]}]},"basePath":"","title":"Get Upload URL - TranscribeTube","deploymentId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","buildId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-CiUHMMOm.js","snippetPresets-BgfXU7Bw.js","utils-DWvOwgy_.js","style-to-object-BY3JEAdk.js","utils-BN7RXSMJ.js","v4-DIgz8zy6.js","addUniqueKeysToSchema-CFw8bq89.js","conditional-requirements-CFM0id0Q.js","cloneDeep-CAwdfOU2.js","_Uint8Array-BJr8e-ZL.js","isObject-FP1Yky1u.js","ApiExamples-XX0UgMZK.js","usePlaygroundInputsStore-DXDFSa1V.js","shallow-CdX5aREi.js","isEqual-CoOaxexF.js","CodeSnippets-Cg2wpzWm.js","CodeSnippet-D_HwgQO_.js","getApiPlaygroundDisplay-CmCoerhe.js","Page-CVJ-f_k1.js","DynamicMarkdown-CQM9Bhbv.js","SectionHeading-DpbrP8nQ.js","icon-BPCgijHy.js","MethodPill-GQ8DuY0c.js","getPastedJson-Cb5mT31m.js","Check2Icon-a7bUI6e8.js","axios-CsQoIw0U.js","Markdown-CX2QY19L.js","AssistantPageLink-CY3bFglh.js","dist-Dl6_zDnT.js","lib-DMeTj1gb.js","lib-B8HbPgcC.js","katex-Dbtb6Wk7.js","html-void-elements-mCSPHezU.js","marked.esm-CZWythHk.js"]}