Requests one downloadable MP4 per recorded page of a session. Assembly runs asynchronously and every page returns as PENDING. Re-posting re-enqueues all pages and retries any that failed. Poll the GET endpoint for per-page status and, on standard (non-BYOS) projects, download URLs.
POST
/
v1
/
sessions
/
{id}
/
recording
/
downloads
Create Session Recording Downloads
curl --request POST \
--url https://api.browserbase.com/v1/sessions/{id}/recording/downloads \
--header 'X-BB-API-Key: <api-key>'
{"docsConfig":{"theme":"maple","$schema":"https://mintlify.com/docs.json","name":"Browserbase Documentation","description":"Browserbase is the Browser Agent Platform: one API key gives your agent everything it needs to browse and interact with the web like a human: Browsers, Fetch, Search, Agent Identity, Functions, and the Model Gateway.","colors":{"primary":"#F03603","light":"#F03603","dark":"#F03603"},"logo":{"light":"https://mintcdn.com/browserbase/SoYEm-IyDzD4GuwP/logo/light.svg?fit=max\u0026auto=format\u0026n=SoYEm-IyDzD4GuwP\u0026q=85\u0026s=67d2dac0a6cdd091f364c6763a3393cd","dark":"https://mintcdn.com/browserbase/SoYEm-IyDzD4GuwP/logo/dark.svg?fit=max\u0026auto=format\u0026n=SoYEm-IyDzD4GuwP\u0026q=85\u0026s=a5e13fbe06c29ec92c87ddef9a46b1c8","href":"https://www.browserbase.com"},"favicon":"https://mintcdn.com/browserbase/giE_cpy18f2mWHqr/favicon.svg?fit=max\u0026auto=format\u0026n=giE_cpy18f2mWHqr\u0026q=85\u0026s=e01181f881b1e04052b2ad95c52bdca0","navbar":{"primary":{"type":"button","label":"Support","href":"https://portal.usepylon.com/browserbase/forms/talk-to-an-engineer"}},"footer":{"socials":{"website":"https://www.browserbase.com","x":"https://x.com/browserbase","github":"https://github.com/browserbase","linkedin":"https://www.linkedin.com/company/browserbasehq"}},"seo":{"indexing":"all"},"fonts":{"heading":{"family":"Inter"},"body":{"family":"Inter"}},"integrations":{"gtm":{"tagId":"GTM-WL6V5CB8"},"posthog":{"apiKey":"phc_L5OdEhuGyIcW1JtLxco9njLYnuUx10mqlVe6Tj54kHS","apiHost":"https://us.i.posthog.com"}},"contextual":{"options":["copy","chatgpt","claude","view","perplexity"],"display":"header"},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"browserbase","hasAudioNarration":false,"actualSubdomain":"browserbase","customDomains":["docs.browserbase.com"],"gitSource":{"type":"github","owner":"browserbase","repo":"core","deployBranch":"main","contentDirectory":"apps/docs","isPrivate":false,"mountPath":"","label":""},"feedback":{"thumbs":true,"edits":false},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6af60ed7885b18cc5269d06d","clientVersion":"0.0.4117","searchFilterCounts":[{"language":"default","tag":"Integrations","count":150},{"language":"default","tag":"Docs","count":89},{"language":"default","tag":"APIs \u0026 SDKs","count":81},{"language":"default","tag":"APIs","count":77},{"language":"default","tag":"Platform","count":62},{"language":"default","tag":"Browsers","count":29},{"language":"default","tag":"Agents","count":14},{"language":"default","tag":"Functions API","count":14},{"language":"default","tag":"Sessions API","count":12},{"language":"default","tag":"Agents API","count":11}]},"assistantConfig":{},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":true,"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":"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":"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}],"googleFontsInlined":false},"customCss":[{"filePath":"style.css","content":"*{border-radius:0!important}.responsive-columns{--_cols: var(--cols, 1);--_cols-effective: min(1, var(--_cols));grid-template-columns:repeat(var(--_cols-effective), 1fr)!important}@container columns-container (min-width: 36rem){.responsive-columns{--_cols-effective: min(2, var(--_cols))}}@container columns-container (min-width: 48rem){.responsive-columns{--_cols-is-4: calc(1 - sign(abs(var(--_cols) - 4)));--_cols-effective: calc(min(3, var(--_cols)) - var(--_cols-is-4))}}@container columns-container (min-width: 64rem){.responsive-columns{--_cols-effective: var(--_cols)}}"}],"page":{"pagePath":"reference/api/create-session-recording-downloads","slug":"/reference/api/create-session-recording-downloads","pageMetadata":{"openapi":"post /v1/sessions/{id}/recording/downloads","title":"Create Session Recording Downloads","description":"Requests one downloadable MP4 per recorded page of a session. Assembly runs asynchronously and every page returns as `PENDING`. Re-posting re-enqueues all pages and retries any that failed. Poll the GET endpoint for per-page status and, on standard (non-BYOS) projects, download URLs.","href":"/reference/api/create-session-recording-downloads"},"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: [\"Requests one downloadable MP4 per recorded page of a session. Assembly runs asynchronously and every page returns as \", _jsx(_components.code, {\n children: \"PENDING\"\n }), \". Re-posting re-enqueues all pages and retries any that failed. Poll the GET endpoint for per-page status and, on standard (non-BYOS) projects, download URLs.\"]\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":{"openapi":"post /v1/sessions/{id}/recording/downloads","title":"Create Session Recording Downloads","description":"Requests one downloadable MP4 per recorded page of a session. Assembly runs asynchronously and every page returns as `PENDING`. Re-posting re-enqueues all pages and retries any that failed. Poll the GET endpoint for per-page status and, on standard (non-BYOS) projects, download URLs.","href":"/reference/api/create-session-recording-downloads"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":["/_mintlify/custom/browserbase/34f72216f660e6f7/signals.js"],"openApiReferenceData":{"operation":{"operationId":"Sessions_createRecordingDownloads","summary":"Create Session Recording Downloads","description":"Requests one downloadable MP4 per recorded page of a session. Assembly runs asynchronously and every page returns as `PENDING`. Re-posting re-enqueues all pages and retries any that failed. Poll the GET endpoint for per-page status and, on standard (non-BYOS) projects, download URLs.","parameters":["a2e42c20-add6-4f8f-a94f-613e2ab9cb46"],"responses":{"202":"afb9dea3-018f-459a-9f4c-6b0eb6f35929","404":"65c0692f-af20-4ed1-add9-d51a619fb23d","409":"55f69330-3d14-4e42-a6bd-dc2e98b40f89","410":"f900ff45-f155-430e-85cd-f78f0fbde2fc","422":"393f964d-f4be-475f-9b22-a57025ab6394","502":"cfe1e7a9-0ed1-4ed8-a263-4c6bf4e0d989"},"method":"post","type":"path","servers":["8d902337-c08c-4780-8819-b5c7bcde4744"],"security":["4ad26dba-9016-43a0-bc83-6ee0c9150264"],"path":"/v1/sessions/{id}/recording/downloads","baseUrlOptions":["https://api.browserbase.com"],"title":"Create Session Recording Downloads","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"a2e42c20-add6-4f8f-a94f-613e2ab9cb46":{"name":"id","in":"path","description":"Session ID","required":true,"schema":{"type":"string","format":"uuid","isRequired":true,"description":"Session ID","uniqueKey":"","typeLabel":"string\u003cuuid>"}}},"responses":{"afb9dea3-018f-459a-9f4c-6b0eb6f35929":{"description":"Downloads enqueued. Poll the GET endpoint for status.","content":{"application/json":{"schema":{"type":"object","properties":{"downloads":{"type":"array","items":{"type":"object","properties":{"pageId":{"description":"Recorded page (tab) within the session, e.g. \"0\", \"1\".","type":"string","isRequired":true,"uniqueKey":"downloads.items.[INDEX].pageId","typeLabel":"string"},"status":{"description":"Per-page MP4 assembly state. `NOT_REQUESTED`: no download has been requested for the session yet. `PENDING`: assembly is enqueued or in progress. `COMPLETED`: the MP4 is ready. `FAILED`: assembly failed; POST again to retry.","type":"string","enum":["NOT_REQUESTED","PENDING","COMPLETED","FAILED"],"isRequired":true,"uniqueKey":"downloads.items.[INDEX].status","typeLabel":"enum\u003cstring>"},"downloadUrl":{"description":"Short-lived signed CDN URL, re-minted each GET. Present only when COMPLETED on a standard (non-BYOS) project.","type":"string","uniqueKey":"downloads.items.[INDEX].downloadUrl","typeLabel":"string"},"completedAt":{"description":"When the MP4 was created. Present only when COMPLETED on a standard (non-BYOS) project.","type":"string","format":"date-time","uniqueKey":"downloads.items.[INDEX].completedAt","typeLabel":"string\u003cdate-time>"}},"required":["pageId","status"],"uniqueKey":"downloads.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"downloads","typeLabel":"object[]"}},"required":["downloads"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"downloads":[{"pageId":"\u003cstring>","status":"NOT_REQUESTED","downloadUrl":"\u003cstring>","completedAt":"2023-11-07T05:31:56Z"}]}}},"exampleType":"generated"}},"exampleType":"generated"},"65c0692f-af20-4ed1-add9-d51a619fb23d":{"description":"The session was not found, or it has no recording.","content":{"application/json":{"schema":{"type":"object","properties":{"statusCode":{"description":"HTTP status code","type":"integer","isRequired":true,"uniqueKey":"statusCode","typeLabel":"integer"},"error":{"description":"HTTP error name","type":"string","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"message":{"description":"Human-readable error message","type":"string","isRequired":true,"uniqueKey":"message","typeLabel":"string"}},"required":["statusCode","error","message"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"statusCode":123,"error":"\u003cstring>","message":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"55f69330-3d14-4e42-a6bd-dc2e98b40f89":{"description":"The session has not ended. Recording downloads are available only after a session completes.","content":{"application/json":{"schema":{"type":"object","properties":{"statusCode":{"description":"HTTP status code","type":"integer","isRequired":true,"uniqueKey":"statusCode","typeLabel":"integer"},"error":{"description":"HTTP error name","type":"string","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"message":{"description":"Human-readable error message","type":"string","isRequired":true,"uniqueKey":"message","typeLabel":"string"}},"required":["statusCode","error","message"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"statusCode":123,"error":"\u003cstring>","message":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"f900ff45-f155-430e-85cd-f78f0fbde2fc":{"description":"The session's recording has aged out of its retention window and can no longer be assembled.","content":{"application/json":{"schema":{"type":"object","properties":{"statusCode":{"description":"HTTP status code","type":"integer","isRequired":true,"uniqueKey":"statusCode","typeLabel":"integer"},"error":{"description":"HTTP error name","type":"string","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"message":{"description":"Human-readable error message","type":"string","isRequired":true,"uniqueKey":"message","typeLabel":"string"}},"required":["statusCode","error","message"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"statusCode":123,"error":"\u003cstring>","message":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"393f964d-f4be-475f-9b22-a57025ab6394":{"description":"Recording was disabled for this session (`recordSession: false`), so there is nothing to assemble.","content":{"application/json":{"schema":{"type":"object","properties":{"statusCode":{"description":"HTTP status code","type":"integer","isRequired":true,"uniqueKey":"statusCode","typeLabel":"integer"},"error":{"description":"HTTP error name","type":"string","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"message":{"description":"Human-readable error message","type":"string","isRequired":true,"uniqueKey":"message","typeLabel":"string"}},"required":["statusCode","error","message"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"statusCode":123,"error":"\u003cstring>","message":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"cfe1e7a9-0ed1-4ed8-a263-4c6bf4e0d989":{"description":"Failed to reach the recording service. Retry the request.","content":{"application/json":{"schema":{"type":"object","properties":{"statusCode":{"description":"HTTP status code","type":"integer","isRequired":true,"uniqueKey":"statusCode","typeLabel":"integer"},"error":{"description":"HTTP error name","type":"string","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"message":{"description":"Human-readable error message","type":"string","isRequired":true,"uniqueKey":"message","typeLabel":"string"}},"required":["statusCode","error","message"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"statusCode":123,"error":"\u003cstring>","message":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"4ad26dba-9016-43a0-bc83-6ee0c9150264":{"BrowserbaseAuth":{"type":"apiKey","in":"header","name":"X-BB-API-Key","description":"Your [Browserbase API Key](https://www.browserbase.com/settings).","scopes":[],"schemeName":"BrowserbaseAuth"}}},"servers":{"8d902337-c08c-4780-8819-b5c7bcde4744":{"url":"https://api.browserbase.com","description":"Public endpoint","variables":{}}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"apiKey","in":"header","name":"X-BB-API-Key","description":"Your [Browserbase API Key](https://www.browserbase.com/settings).","scopes":[],"schemeName":"BrowserbaseAuth"},"schema":{"title":"X-BB-API-Key","type":"string","description":"Your [Browserbase API Key](https://www.browserbase.com/settings).","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"BrowserbaseAuth","name":"X-BB-API-Key"}],"title":"BrowserbaseAuth"}]},"originalFileLocation":"reference/api/openapi.v1.yaml"},"subdomain":"browserbase","siteName":"Browserbase Documentation","title":"Create Session Recording Downloads - Browserbase Documentation","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-07-14T19:39:05.722Z","originalFileLocation":"reference/api/create-session-recording-downloads.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=\"Requests one downloadable MP4 per recorded page of a session. Assembly runs asynchronously and every page returns as PENDING. Re-posting re-enqueues all pages and retries any that failed. Poll the GET endpoint for per-page status and, on standard (non-BYOS) projects, download URLs.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Browserbase Documentation\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/browserbase/0gEfmyCMfQGLZuAR/_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/browserbase/0gEfmyCMfQGLZuAR/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/browserbase/0gEfmyCMfQGLZuAR/_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/browserbase/0gEfmyCMfQGLZuAR/_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/browserbase/0gEfmyCMfQGLZuAR/_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/browserbase/0gEfmyCMfQGLZuAR/_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/browserbase/0gEfmyCMfQGLZuAR/_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/browserbase/0gEfmyCMfQGLZuAR/_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/browserbase/0gEfmyCMfQGLZuAR/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Create Session Recording Downloads - Browserbase Documentation\">\u003cmeta data-mint-head property=\"og:description\" content=\"Requests one downloadable MP4 per recorded page of a session. Assembly runs asynchronously and every page returns as PENDING. Re-posting re-enqueues all pages and retries any that failed. Poll the GET endpoint for per-page status and, on standard (non-BYOS) projects, download URLs.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Browserbase Documentation\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.browserbase.com/reference/api/create-session-recording-downloads\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://browserbase.mintlify.site/_mintlify/api/og/v2?division=Sessions+API\u0026amp;title=Create+Session+Recording+Downloads\u0026amp;description=Requests+one+downloadable+MP4+per+recorded+page+of+a+session.+Assembly+runs+asynchronously+and+every+page+returns+as+%60PENDING%60.+Re-posting+re-enqueues+all+pages\u0026amp;theme=271c3501a74b3d8f26be78f7\u0026amp;signature=625096e3c72ced9a173c462e13525327221385d0cce352d3dbb251b34ca1e95a\">\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=\"Create Session Recording Downloads - Browserbase Documentation\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Requests one downloadable MP4 per recorded page of a session. Assembly runs asynchronously and every page returns as PENDING. Re-posting re-enqueues all pages and retries any that failed. Poll the GET endpoint for per-page status and, on standard (non-BYOS) projects, download URLs.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://browserbase.mintlify.site/_mintlify/api/og/v2?division=Sessions+API\u0026amp;title=Create+Session+Recording+Downloads\u0026amp;description=Requests+one+downloadable+MP4+per+recorded+page+of+a+session.+Assembly+runs+asynchronously+and+every+page+returns+as+%60PENDING%60.+Re-posting+re-enqueues+all+pages\u0026amp;theme=271c3501a74b3d8f26be78f7\u0026amp;signature=625096e3c72ced9a173c462e13525327221385d0cce352d3dbb251b34ca1e95a\">\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/browserbase/0gEfmyCMfQGLZuAR/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Browserbase Documentation\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#F03603\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.browserbase.com/reference/api/create-session-recording-downloads\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/reference/api/create-session-recording-downloads.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.browserbase.com/#organization\",\"name\":\"Browserbase Documentation\",\"url\":\"https://docs.browserbase.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/browserbase/SoYEm-IyDzD4GuwP/logo/light.svg?fit=max\u0026auto=format\u0026n=SoYEm-IyDzD4GuwP\u0026q=85\u0026s=67d2dac0a6cdd091f364c6763a3393cd\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.browserbase.com#website\",\"name\":\"Browserbase Documentation\",\"url\":\"https://docs.browserbase.com\",\"publisher\":{\"@id\":\"https://docs.browserbase.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.browserbase.com/reference/api/create-session-recording-downloads#webpage\",\"url\":\"https://docs.browserbase.com/reference/api/create-session-recording-downloads\",\"name\":\"Create Session Recording Downloads\",\"description\":\"Requests one downloadable MP4 per recorded page of a session. Assembly runs asynchronously and every page returns as PENDING. Re-posting re-enqueues all pages and retries any that failed. Poll the GET endpoint for per-page status and, on standard (non-BYOS) projects, download URLs.\",\"dateModified\":\"2026-07-14T19:39:05.722Z\",\"isPartOf\":{\"@id\":\"https://docs.browserbase.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.browserbase.com/reference/api/create-session-recording-downloads#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.browserbase.com/reference/api/create-session-recording-downloads#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"APIs\",\"item\":\"https://docs.browserbase.com/reference/api/overview\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Sessions API\",\"item\":\"https://docs.browserbase.com/reference/api/create-a-session\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Create Session Recording Downloads\",\"item\":\"https://docs.browserbase.com/reference/api/create-session-recording-downloads\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.browserbase.com/reference/api/create-session-recording-downloads#apireference\",\"headline\":\"Create Session Recording Downloads\",\"name\":\"Create Session Recording Downloads\",\"description\":\"Requests one downloadable MP4 per recorded page of a session. Assembly runs asynchronously and every page returns as PENDING. Re-posting re-enqueues all pages and retries any that failed. Poll the GET endpoint for per-page status and, on standard (non-BYOS) projects, download URLs.\",\"url\":\"https://docs.browserbase.com/reference/api/create-session-recording-downloads\",\"mainEntityOfPage\":{\"@id\":\"https://docs.browserbase.com/reference/api/create-session-recording-downloads#webpage\"},\"dateModified\":\"2026-07-14T19:39:05.722Z\",\"publisher\":{\"@id\":\"https://docs.browserbase.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.browserbase.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Browserbase Documentation\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Browserbase Documentation\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/reference/api/create-session-recording-downloads.md","siteName":"Browserbase Documentation","nav":{"global":null,"tabs":[{"tab":"Docs","pages":[{"title":"Docs","href":"/welcome/introduction"}]},{"tab":"APIs \u0026 SDKs","groups":[{"group":"Overview","pages":[{"title":"APIs and SDKs","sidebarTitle":"Introduction","href":"/reference/introduction"}]},{"group":"SDKs","pages":[{"title":"Overview","href":"/reference/sdk/overview"},{"title":"Node.js SDK","href":"/reference/sdk/nodejs"},{"title":"Python SDK","href":"/reference/sdk/python"}]},{"group":"APIs","pages":[{"title":"Overview","href":"/reference/api/overview"},{"group":"Sessions API","pages":[{"openapi":"post /v1/sessions","title":"Create a Session","href":"/reference/api/create-a-session"},{"openapi":"get /v1/sessions","title":"List Sessions","href":"/reference/api/list-sessions"},{"openapi":"get /v1/sessions/{id}","title":"Get a Session","href":"/reference/api/get-a-session"},{"openapi":"put /v1/sessions/{id}/labels","title":"Set Session Labels","href":"/reference/api/set-session-labels"},{"title":"Update a Session","openapi":"post /v1/sessions/{id}","href":"/reference/api/update-a-session"},{"openapi":"get /v1/sessions/{id}/debug","title":"Session Live URLs","href":"/reference/api/session-live-urls"},{"openapi":"get /v1/sessions/{id}/logs","title":"Session Logs","href":"/reference/api/session-logs"},{"openapi":"get /v1/sessions/{id}/replays","title":"Get Session Replay","href":"/reference/api/session-replays"},{"openapi":"get /v1/sessions/{id}/replays/{pageId}","title":"Get Replay Page","description":"Returns an HLS VOD media playlist (.m3u8) for a specific page of a session replay.","href":"/reference/api/session-replay-page"},{"openapi":"post /v1/sessions/{id}/recording/downloads","title":"Create Session Recording Downloads","href":"/reference/api/create-session-recording-downloads"},{"openapi":"get /v1/sessions/{id}/recording/downloads","title":"List Session Recording Downloads","description":"Returns the per-page download status for a session, with a short-lived signed URL for each completed page on standard (non-BYOS) projects.","href":"/reference/api/list-session-recording-downloads"},{"openapi":"post /v1/sessions/{id}/uploads","title":"Create Session Uploads","href":"/reference/api/create-session-uploads"}]},{"group":"Labels API","pages":[{"openapi":"get /v1/labels","title":"List Labels","href":"/reference/api/list-labels"},{"openapi":"post /v1/labels","title":"Create a Label","href":"/reference/api/create-a-label"},{"openapi":"patch /v1/labels/{labelId}","title":"Update a Label","href":"/reference/api/update-a-label"},{"openapi":"delete /v1/labels/{labelId}","title":"Delete a Label","href":"/reference/api/delete-a-label"}]},{"group":"Fetch API","pages":[{"openapi":"post /v1/fetch","title":"Fetch a Page","href":"/reference/api/fetch-a-page"}]},{"group":"Search API","pages":[{"openapi":"post /v1/search","title":"Web Search","href":"/reference/api/web-search"}]},{"group":"Agents API","pages":[{"group":"Runs","pages":[{"openapi":"post /v1/agents/runs","title":"Run an Agent","href":"/reference/api/run-an-agent"},{"openapi":"get /v1/agents/runs/{runId}","title":"Get a Run","href":"/reference/api/get-a-run"},{"openapi":"get /v1/agents/runs","title":"List Runs","href":"/reference/api/list-runs"},{"openapi":"get /v1/agents/runs/{runId}/messages","title":"List Run Messages","href":"/reference/api/list-run-messages"},{"openapi":"post /v1/agents/runs/{runId}/resume","title":"Resume a Run","href":"/reference/api/resume-a-run"},{"openapi":"post /v1/agents/runs/{runId}/stop","title":"Stop a Run","href":"/reference/api/stop-a-run"}]},{"group":"Agents","pages":[{"openapi":"post /v1/agents","title":"Create an Agent","href":"/reference/api/create-an-agent"},{"openapi":"get /v1/agents/{agentId}","title":"Get an Agent","href":"/reference/api/get-an-agent"},{"openapi":"get /v1/agents","title":"List Agents","href":"/reference/api/list-agents"},{"openapi":"patch /v1/agents/{agentId}","title":"Update an Agent","href":"/reference/api/update-an-agent"},{"openapi":"delete /v1/agents/{agentId}","title":"Delete an Agent","href":"/reference/api/delete-an-agent"}]}]},{"group":"Functions API","pages":[{"openapi":"get /v1/functions","title":"List Functions","href":"/reference/api/list-functions"},{"openapi":"get /v1/functions/{id}","title":"Get a Function","href":"/reference/api/get-a-function"},{"openapi":"post /v1/functions/{id}/invoke","title":"Invoke a Function","href":"/reference/api/invoke-a-function"},{"group":"Secrets","pages":[{"openapi":"get /v1/functions/{id}/secrets","title":"List Function Secrets","href":"/reference/api/list-function-secrets"},{"openapi":"post /v1/functions/{id}/secrets","title":"Attach a Secret to a Function","href":"/reference/api/attach-a-secret-to-a-function"},{"openapi":"delete /v1/functions/{id}/secrets/{secretId}","title":"Detach a Secret from a Function","href":"/reference/api/detach-a-secret-from-a-function"}]},{"group":"Versions","pages":[{"openapi":"get /v1/functions/{id}/versions","title":"List Function Versions","href":"/reference/api/list-function-versions"},{"openapi":"get /v1/functions/versions/{id}","title":"Get a Function Version","href":"/reference/api/get-a-function-version"}]},{"group":"Builds","pages":[{"openapi":"get /v1/functions/builds","title":"List Function Builds","href":"/reference/api/list-function-builds"},{"openapi":"get /v1/functions/builds/{id}","title":"Get a Function Build","href":"/reference/api/get-a-function-build"},{"openapi":"get /v1/functions/builds/{id}/logs","title":"Get Function Build Logs","href":"/reference/api/get-function-build-logs"}]},{"group":"Invocations","pages":[{"openapi":"get /v1/functions/invocations/{id}","title":"Get an Invocation","href":"/reference/api/get-an-invocation"},{"openapi":"get /v1/functions/invocations/{id}/logs","title":"Get Invocation Logs","href":"/reference/api/get-invocation-logs"},{"openapi":"get /v1/functions/versions/{id}/invocations","title":"List Invocations for a Function Version","href":"/reference/api/list-version-invocations"}]}]},{"group":"Secrets API","pages":[{"openapi":"get /v1/secrets/keypair","title":"Get a Keypair","href":"/reference/api/get-a-keypair"},{"openapi":"post /v1/secrets","title":"Create a Secret","href":"/reference/api/create-a-secret"},{"openapi":"get /v1/secrets","title":"List Secrets","href":"/reference/api/list-secrets"},{"openapi":"get /v1/secrets/{id}","title":"Get a Secret","href":"/reference/api/get-a-secret"},{"openapi":"patch /v1/secrets/{id}","title":"Update a Secret","href":"/reference/api/update-a-secret"},{"openapi":"delete /v1/secrets/{id}","title":"Delete a Secret","href":"/reference/api/delete-a-secret"}]},{"group":"Downloads API","pages":[{"openapi":"get /v1/downloads","title":"List Downloads","href":"/reference/api/list-downloads"},{"openapi":"get /v1/downloads/{id}","title":"Get a Download","href":"/reference/api/get-a-download"},{"openapi":"delete /v1/downloads/{id}","title":"Delete a Download","href":"/reference/api/delete-a-download"}]},{"group":"Contexts API","pages":[{"openapi":"post /v1/contexts","title":"Create a Context","href":"/reference/api/create-a-context"},{"openapi":"get /v1/contexts/{id}","title":"Get a Context","href":"/reference/api/get-a-context"},{"openapi":"delete /v1/contexts/{id}","title":"Delete a Context","href":"/reference/api/delete-a-context"}]},{"group":"Navigation policies API","pages":[{"openapi":"post /v1/navigation-policies","title":"Create a Navigation Policy","href":"/reference/api/create-a-navigation-policy"},{"openapi":"get /v1/navigation-policies","title":"List Navigation Policies","href":"/reference/api/list-navigation-policies"},{"openapi":"get /v1/navigation-policies/{id}","title":"Get a Navigation Policy","href":"/reference/api/get-a-navigation-policy"},{"openapi":"patch /v1/navigation-policies/{id}","title":"Update a Navigation Policy","href":"/reference/api/update-a-navigation-policy"},{"openapi":"delete /v1/navigation-policies/{id}","title":"Delete a Navigation Policy","href":"/reference/api/delete-a-navigation-policy"}]},{"group":"Extensions API","pages":[{"openapi":"post /v1/extensions","title":"Upload an Extension","href":"/reference/api/upload-an-extension"},{"openapi":"get /v1/extensions/{id}","title":"Get an Extension","href":"/reference/api/get-an-extension"},{"openapi":"delete /v1/extensions/{id}","title":"Delete an Extension","href":"/reference/api/delete-an-extension"}]},{"group":"Certificates API","pages":[{"openapi":"post /v1/certificates","title":"Upload a Certificate","href":"/reference/api/upload-a-certificate"},{"openapi":"get /v1/certificates","title":"List Certificates","href":"/reference/api/list-certificates"},{"openapi":"get /v1/certificates/{id}","title":"Get a Certificate","href":"/reference/api/get-a-certificate"},{"openapi":"delete /v1/certificates/{id}","title":"Delete a Certificate","href":"/reference/api/delete-a-certificate"}]},{"group":"Webhooks API","pages":[{"openapi":"post /v1/webhooks","title":"Create a Webhook","href":"/reference/api/create-a-webhook"},{"openapi":"get /v1/webhooks","title":"List Webhooks","href":"/reference/api/list-webhooks"},{"openapi":"get /v1/webhooks/{id}","title":"Get a Webhook","href":"/reference/api/get-a-webhook"},{"openapi":"patch /v1/webhooks/{id}","title":"Update a Webhook","href":"/reference/api/update-a-webhook"},{"openapi":"delete /v1/webhooks/{id}","title":"Delete a Webhook","href":"/reference/api/delete-a-webhook"},{"openapi":"post /v1/webhooks/{id}/secret","title":"Rotate a Webhook signing secret","href":"/reference/api/rotate-a-webhook-signing-secret"}]},{"group":"Projects API","pages":[{"openapi":"get /v1/projects","title":"List Projects","href":"/reference/api/list-projects"},{"openapi":"get /v1/projects/{id}","title":"Get a Project","href":"/reference/api/get-a-project"},{"openapi":"get /v1/projects/{id}/usage","title":"Get Project Usage","href":"/reference/api/get-project-usage"}]}]}]},{"tab":"Integrations","pages":[{"title":"Integrations","href":"/integrations/get-started"}]},{"tab":"Templates ↗","href":"https://www.browserbase.com/templates"},{"tab":"Stagehand ↗","href":"https://docs.stagehand.dev/"},{"tab":"Changelog ↗","href":"https://www.browserbase.com/changelog"},{"tab":"Dashboard ↗","href":"https://www.browserbase.com/overview"}]},"basePath":"","title":"Create Session Recording Downloads - Browserbase Documentation","buildId":"dpl_41S5Z2jG9QnfDRwN1KZrLdBwj7DM","deploymentId":"dpl_41S5Z2jG9QnfDRwN1KZrLdBwj7DM","dynamics":["c2aa737661","b0f84f53ff","a9bb46feb3","2b790eda92"],"chunks":["OpenApiReferenceProvider-DDP9JXtj.js","utils-8yQyvEtx.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-CBCFR8Sn.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-rQaXkUHa.js","snippetPresets-J5KpBTgV.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","Page-DTNSD-0M.js","ApiExamples-BVxVH4Cj.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-BxdQ2vIi.js","shallow-BjV2tFiD.js","getApiPlaygroundDisplay-C_55tL4O.js","CodeSnippet-C0JpiCOC.js","CodeSnippets-w9Ps7djG.js","getPastedJson-BDfB-H8d.js","icon-g-kUkkO9.js","MethodPill-v4l6fq0h.js","DuplicateIcon-CvLo-CfU.js","createIcon-165clrrV.js","DynamicMarkdown-D3RQ-fEj.js","SectionHeading-vvo-3yLf.js","axios-vUo_bRtp.js","Markdown-CMT1uFWQ.js","clsx-C8f2yC9R.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-CI2D8R2Y.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-k78Wrw_e.js"]}