Add a new build to an existing app. By default the new build is promoted to active; pass set_as_current: false to leave the active build unchanged.Call POST /apps/upload-url first to obtain an s3_key.
Returns { message, build, app }. app.current_build reflects the new active build when set_as_current is true. build.arch is "arm64" / "x86_64" / "universal" for Android (auto-detected from the binary) and null for iOS.
Missing/invalid field, bad extension, or 32-bit-only Android binary.
403
No mobile concurrency on plan, or s3_key not owned by your company.
404
App not found in your account.
409
A build named name already exists for this app.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Docket","colors":{"primary":"#0C1536","light":"#3D3D3D","dark":"#161716"},"logo":{"light":"https://mintcdn.com/docket-dcd24ade/Kks4baIOAtT7fIac/logo/light-logo.png?fit=max\u0026auto=format\u0026n=Kks4baIOAtT7fIac\u0026q=85\u0026s=332c1328fcf4bcff34ccb925a52a9f9d","dark":"https://mintcdn.com/docket-dcd24ade/Kks4baIOAtT7fIac/logo/dark-logo.png?fit=max\u0026auto=format\u0026n=Kks4baIOAtT7fIac\u0026q=85\u0026s=8fd2d71eabcd71c31b55d38c9a53fb91"},"favicon":"https://mintcdn.com/docket-dcd24ade/Kks4baIOAtT7fIac/favicon.ico?fit=max\u0026auto=format\u0026n=Kks4baIOAtT7fIac\u0026q=85\u0026s=9091a9d2b1bd5dc64086efb1a957c93b","api":{"mdx":{"auth":{"method":"key","name":"X-API-KEY"},"server":"https://api.docketqa.com"}},"navbar":{"links":[{"href":"mailto:founders@docketqa.com","label":"Support"}],"primary":{"type":"button","label":"Dashboard","href":"https://app.docketqa.com/"}},"footer":{"socials":{"x":"https://x.com/docketqa","linkedin":"https://www.linkedin.com/company/docketqa"}},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"docket-dcd24ade","hasAudioNarration":false,"actualSubdomain":"docket-dcd24ade","customDomains":["docs.docketqa.com"],"gitSource":{"type":"github","owner":"signdocket","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6a29dccf12cc5a4abec302a6","collectionId":"1129c413-6621-40fb-b8ef-d9d715faad07","schemaVersion":"v2"},"entitlements":{},"buildId":"6a29dccf12cc5a4abec302a6:success","clientVersion":"0.0.3966","searchFilterCounts":[{"language":"default","tag":"API Reference","count":14},{"language":"default","tag":"Core Concepts","count":8},{"language":"default","tag":"Mobile Apps","count":5},{"language":"default","tag":"Modules","count":4},{"language":"default","tag":"Tests","count":4},{"language":"default","tag":"Features","count":4},{"language":"default","tag":"Running Tests","count":3},{"language":"default","tag":"Test Generation","count":2},{"language":"default","tag":"Integrations","count":2},{"language":"default","tag":"Get Started","count":2}]},"assistantConfig":{},"hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-v7-file-tree","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"pause-universal-search-reconcile","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":"per-site-search-delta","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":"editor-private-page-search","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":"editor-nav-generations","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":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"byok-sep-25","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-agent-model-picker","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-updated-9-15","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"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}],"isAtlas":false,"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/endpoint/create-build","slug":"/api-reference/endpoint/create-build","pageMetadata":{"title":"Create Build","api":"POST /apps/{id}/builds","description":null,"href":"/api-reference/endpoint/create-build"},"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`,em:`em`,p:`p`,pre:`pre`,span:`span`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,..._provideComponents(),...props.components},{CodeBlock,Heading,Note,ParamField,Table}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Note)_missingMdxReference(`Note`,true);if(!ParamField)_missingMdxReference(`ParamField`,true);if(!Table)_missingMdxReference(`Table`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`Add a new build to an existing app. By default the new build is promoted to active; pass `,_jsx(_components.code,{children:`set_as_current: false`}),` to leave the active build unchanged.`]}),`\n`,_jsxs(_components.p,{children:[`Call `,_jsx(_components.a,{href:`/api-reference/endpoint/upload-build`,children:`POST /apps/upload-url`}),` first to obtain an `,_jsx(_components.code,{children:`s3_key`}),`.`]}),`\n`,_jsx(Heading,{level:`2`,id:`path-parameters`,children:`Path parameters`}),`\n`,_jsx(ParamField,{path:`id`,type:`integer`,required:true,id:`param-id`,children:`App ID.`}),`\n`,_jsx(Heading,{level:`2`,id:`request-body`,children:`Request body`}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[`The build name field is `,_jsx(_components.code,{children:`name`}),` on this endpoint. (When creating an app’s `,_jsx(_components.em,{children:`first`}),` build via `,_jsx(_components.a,{href:`/api-reference/endpoint/create-app`,children:`POST /apps/create`}),` the equivalent field is `,_jsx(_components.code,{children:`build_name`}),`.)`]})}),`\n`,_jsx(ParamField,{body:`name`,type:`string`,required:true,id:`param-name`,children:`Unique within the app. Max 255 chars.`}),`\n`,_jsxs(ParamField,{body:`s3_key`,type:`string`,required:true,id:`param-s3-key`,children:[`From `,_jsx(_components.a,{href:`/api-reference/endpoint/upload-build`,children:`POST /apps/upload-url`}),`. Must belong to your company.`]}),`\n`,_jsx(ParamField,{body:`file_size`,type:`integer`,required:true,id:`param-file-size`,children:`Bytes uploaded.`}),`\n`,_jsx(ParamField,{body:`original_filename`,type:`string`,id:`param-original-filename`,children:`Used to preserve the file extension.`}),`\n`,_jsxs(ParamField,{body:`set_as_current`,type:`boolean`,id:`param-set-as-current`,children:[`Default `,_jsx(_components.code,{children:`true`}),`. Set `,_jsx(_components.code,{children:`false`}),` to upload a build without affecting running tests; promote it later with `,_jsx(_components.a,{href:`/api-reference/endpoint/set-current-build`,children:`Set Active Build`}),`.`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`6`,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:`6`,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:` \"name\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"v1.2.0\"`}),_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:` \"s3_key\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"files/2/9c2e7f5a-..._acme.apk\"`}),_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:` \"file_size\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`92012544`}),_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:` \"original_filename\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"acme.apk\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),`\n`,_jsx(Heading,{level:`2`,id:`response`,children:`Response`}),`\n`,_jsxs(_components.p,{children:[`Returns `,_jsx(_components.code,{children:`{ message, build, app }`}),`. `,_jsx(_components.code,{children:`app.current_build`}),` reflects the new active build when `,_jsx(_components.code,{children:`set_as_current`}),` is `,_jsx(_components.code,{children:`true`}),`. `,_jsx(_components.code,{children:`build.arch`}),` is `,_jsx(_components.code,{children:`\"arm64\"`}),` / `,_jsx(_components.code,{children:`\"x86_64\"`}),` / `,_jsx(_components.code,{children:`\"universal\"`}),` for Android (auto-detected from the binary) and `,_jsx(_components.code,{children:`null`}),` for iOS.`]}),`\n`,_jsx(Heading,{level:`2`,id:`errors`,children:`Errors`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Status`}),_jsx(_components.th,{children:`Cause`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`400`})}),_jsx(_components.td,{children:`Missing/invalid field, bad extension, or 32-bit-only Android binary.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`403`})}),_jsxs(_components.td,{children:[`No mobile concurrency on plan, or `,_jsx(_components.code,{children:`s3_key`}),` not owned by your company.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`404`})}),_jsx(_components.td,{children:`App not found in your account.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`409`})}),_jsxs(_components.td,{children:[`A build named `,_jsx(_components.code,{children:`name`}),` already exists for this app.`]})]})]})]})]})}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":"Create Build","api":"POST /apps/{id}/builds","description":null,"href":"/api-reference/endpoint/create-build"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Path parameters","slug":"path-parameters","depth":2,"children":[]},{"title":"Request body","slug":"request-body","depth":2,"children":[]},{"title":"Response","slug":"response","depth":2,"children":[]},{"title":"Errors","slug":"errors","depth":2,"children":[]}],"codeExamples":{},"endpoint":{"title":"Create Build","path":"/apps/{id}/builds","servers":[{"url":"https://api.docketqa.com"}],"method":"post","request":{"security":[{"title":"API Key Auth","parameters":{"header":{"X-API-KEY":{"type":"apiKey"}},"query":{},"cookie":{}}}],"parameters":{"query":{},"header":{},"cookie":{},"path":{"id":{"schema":[{"type":"integer","description":"App ID.","required":true}]}}},"body":{"application/json":{"schemaArray":[{"type":"object","properties":{"name":[{"type":"string","description":"Unique within the app. Max 255 chars.","required":true}],"s3_key":[{"type":"string","description":"From POST /apps/upload-url . Must belong to your company.","required":true}],"file_size":[{"type":"integer","description":"Bytes uploaded.","required":true}],"original_filename":[{"type":"string","description":"Used to preserve the file extension."}],"set_as_current":[{"type":"boolean","description":"Default `true` . Set `false` to upload a build without affecting running tests; promote it later with Set Active Build ."}]}}],"examples":{"example":{"value":{"name":"\u003cstring>","s3_key":"\u003cstring>","file_size":123,"original_filename":"\u003cstring>","set_as_current":true}}}}}},"response":{},"deprecated":false}},"jsLinks":[],"subdomain":"docket-dcd24ade","siteName":"Docket","title":"Create Build - Docket","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-04-27T23:17:25.561Z","originalFileLocation":"api-reference/endpoint/create-build.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=\"application-name\" content=\"Docket\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/docket-dcd24ade/hKkMmOdnvUSM1sSd/_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/docket-dcd24ade/hKkMmOdnvUSM1sSd/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/docket-dcd24ade/hKkMmOdnvUSM1sSd/_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/docket-dcd24ade/hKkMmOdnvUSM1sSd/_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/docket-dcd24ade/hKkMmOdnvUSM1sSd/_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/docket-dcd24ade/hKkMmOdnvUSM1sSd/_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/docket-dcd24ade/hKkMmOdnvUSM1sSd/_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/docket-dcd24ade/hKkMmOdnvUSM1sSd/_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/docket-dcd24ade/hKkMmOdnvUSM1sSd/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Create Build - Docket\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Docket\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.docketqa.com/api-reference/endpoint/create-build\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://docket-dcd24ade.mintlify.app/_mintlify/api/og/v2?division=Mobile+Apps\u0026amp;title=Create+Build\u0026amp;theme=9d8587413f998365bae41aae\u0026amp;signature=89e4cdebd6917590d8814e3662ab5c81e8845f1669762e04233b4e4929374ca6\">\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 Build - Docket\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://docket-dcd24ade.mintlify.app/_mintlify/api/og/v2?division=Mobile+Apps\u0026amp;title=Create+Build\u0026amp;theme=9d8587413f998365bae41aae\u0026amp;signature=89e4cdebd6917590d8814e3662ab5c81e8845f1669762e04233b4e4929374ca6\">\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/docket-dcd24ade/hKkMmOdnvUSM1sSd/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Docket\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#0C1536\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.docketqa.com/api-reference/endpoint/create-build\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/endpoint/create-build.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.docketqa.com/#organization\",\"name\":\"Docket\",\"url\":\"https://docs.docketqa.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/docket-dcd24ade/Kks4baIOAtT7fIac/logo/light-logo.png?fit=max\u0026auto=format\u0026n=Kks4baIOAtT7fIac\u0026q=85\u0026s=332c1328fcf4bcff34ccb925a52a9f9d\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.docketqa.com#website\",\"name\":\"Docket\",\"url\":\"https://docs.docketqa.com\",\"publisher\":{\"@id\":\"https://docs.docketqa.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.docketqa.com/api-reference/endpoint/create-build#webpage\",\"url\":\"https://docs.docketqa.com/api-reference/endpoint/create-build\",\"name\":\"Create Build\",\"dateModified\":\"2026-04-27T23:17:25.561Z\",\"isPartOf\":{\"@id\":\"https://docs.docketqa.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.docketqa.com/api-reference/endpoint/create-build#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.docketqa.com/api-reference/endpoint/create-build#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"API Reference\",\"item\":\"https://docs.docketqa.com/api-reference/introduction\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Mobile Apps\",\"item\":\"https://docs.docketqa.com/api-reference/endpoint/upload-build\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Create Build\",\"item\":\"https://docs.docketqa.com/api-reference/endpoint/create-build\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.docketqa.com/api-reference/endpoint/create-build#apireference\",\"headline\":\"Create Build\",\"name\":\"Create Build\",\"url\":\"https://docs.docketqa.com/api-reference/endpoint/create-build\",\"mainEntityOfPage\":{\"@id\":\"https://docs.docketqa.com/api-reference/endpoint/create-build#webpage\"},\"dateModified\":\"2026-04-27T23:17:25.561Z\",\"publisher\":{\"@id\":\"https://docs.docketqa.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.docketqa.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Docket\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Docket","nav":{"global":null,"groups":[{"group":"Get Started","pages":[{"title":"Welcome to Docket","href":"/welcome"},{"title":"Quickstart","href":"/quickstart"}]},{"group":"Core Concepts","pages":[{"title":"Test Suites","icon":"folder","href":"/essentials/test-suite"},{"title":"Creating a Test","icon":"pen","href":"/essentials/test-creation"},{"title":"Remote Screen","icon":"display","href":"/essentials/remote-screen"},{"title":"Mobile Apps","icon":"mobile-screen","href":"/essentials/mobile-apps"},{"title":"Folders","icon":"folder","href":"/essentials/folders"},{"title":"AI Steps","icon":"sparkles","href":"/essentials/ai-steps"},{"title":"Recorded Steps","icon":"bolt","href":"/essentials/recorded-steps"},{"title":"Agent Rules","icon":"folder-grid","href":"/essentials/agent-context"}]},{"group":"Running Tests","pages":[{"title":"Running a Test","icon":"play","href":"/essentials/running-test"},{"title":"Triggering Tests","icon":"bolt","href":"/essentials/triggering-tests"},{"title":"CI Integration","icon":"github","href":"/essentials/ci-integration"}]},{"group":"Test Generation","pages":[{"title":"Bulk Create","icon":"layer-group","href":"/essentials/bulk-create"},{"title":"Generate Tests","icon":"sparkles","href":"/essentials/generate-tests"}]},{"group":"Features","pages":[{"title":"Files","icon":"paperclip","href":"/essentials/file-upload"},{"title":"Dedicated Mailboxes","icon":"envelope","href":"/essentials/dedicated-mailboxes"},{"title":"Anti-Bot Detection","icon":"shield","href":"/essentials/bot-detection"},{"title":"Docket Tunnel","icon":"plug","href":"/essentials/tunnel"}]},{"group":"Integrations","pages":[{"title":"Failure Notifications","icon":"bell","href":"/essentials/notifications"},{"title":"Webhooks","icon":"webhook","href":"/essentials/webhooks"}]},{"group":"API Reference","pages":[{"title":"API Reference","icon":"code","href":"/api-reference/introduction"},{"group":"Tests","pages":[{"title":"Create Test","api":"POST /test_blueprint/create","href":"/api-reference/endpoint/create-test"},{"title":"Run Test","api":"POST /test_group_run/trigger_run","href":"/api-reference/endpoint/run-test"},{"title":"Get Test Run","api":"GET /test_run/{test_run_id}","href":"/api-reference/endpoint/get-test-run"},{"title":"List Tests","api":"GET /test_blueprint/list","href":"/api-reference/endpoint/list-tests"}]},{"group":"Modules","pages":[{"title":"Create Module","api":"POST /modules/create","href":"/api-reference/endpoint/create-module"},{"title":"Get Module","api":"GET /modules/{module_id}","href":"/api-reference/endpoint/get-module"},{"title":"List Modules","api":"GET /modules/list","href":"/api-reference/endpoint/list-modules"},{"title":"Update Module","api":"PUT /modules/{module_id}","href":"/api-reference/endpoint/update-module"}]},{"group":"Mobile Apps","pages":[{"title":"Upload a Build","api":"POST /apps/upload-url","href":"/api-reference/endpoint/upload-build"},{"title":"Create App","api":"POST /apps/create","href":"/api-reference/endpoint/create-app"},{"title":"List Apps","api":"GET /apps/list","description":null,"href":"/api-reference/endpoint/list-apps"},{"title":"Create Build","api":"POST /apps/{id}/builds","href":"/api-reference/endpoint/create-build"},{"title":"Set Active Build","api":"PUT /apps/{id}/builds/{build_id}/set-current","description":null,"href":"/api-reference/endpoint/set-current-build"}]}]}]},"title":"Create Build - Docket","buildId":"dpl_cadrRc5H9XQiJQbDFN5mcYRs2PAj","deploymentId":"dpl_cadrRc5H9XQiJQbDFN5mcYRs2PAj","dynamics":["c2aa737661","2b790eda92","b0f84f53ff"],"chunks":["OpenApiReferenceProvider-DKJwRUt2.js","utils-CWD_VS3u.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-oFjciODD.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-C76WsxC3.js","snippetPresets-DvPMxpX_.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-CuNQfndH.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-BVFpVUoF.js","shallow-t59Jg5Kr.js","getApiPlaygroundDisplay-C_JZ4amX.js","CodeSnippet-CLRDnx_h.js","CodeSnippets-C2myU4kc.js","Page-7TwLLapg.js","getPastedJson-B-JaVXw7.js","icon-BA-iDhH3.js","MethodPill-D4qZABFp.js","DuplicateIcon-THIDKO1O.js","createIcon-CYYJwgFd.js","DynamicMarkdown-UGQuxDKp.js","SectionHeading-jYELb23h.js","axios-vUo_bRtp.js"]}