Cold-boots from the persisted configuration and disks. If the sandbox
was paused, its memory snapshot is consumed and discarded before the
new VM runs; disk state remains. Without mount changes, starting a running
sandbox or a pending cold start is idempotent. A sandbox that is stopping,
pausing, or pending a resume returns 409. Providing mounts replaces the
additional disk mounts for this and later sessions and requires an inactive
sandbox; omit it to preserve saved mounts.
Replace the sandbox's additional disk mounts for this and later sessions. Omit to keep the current ones; an empty list removes all additional mounts without deleting their disks. The internal root disk is unaffected. Not accepted by resume, and 409 while the sandbox is running or pending.
{"docsConfig":{"theme":"sequoia","$schema":"https://mintlify.com/docs.json","name":"Archil","colors":{"primary":"#CA5550","light":"#CA5550","dark":"#CA5550"},"logo":{"light":"https://mintcdn.com/regattastorage/ZgodyIZMQ_rX_qud/logo/archil-black-fullbleed.svg?fit=max\u0026auto=format\u0026n=ZgodyIZMQ_rX_qud\u0026q=85\u0026s=adba0f4983e37336b24452e3ba977724","dark":"https://mintcdn.com/regattastorage/ZgodyIZMQ_rX_qud/logo/archil-white-fullbleed.svg?fit=max\u0026auto=format\u0026n=ZgodyIZMQ_rX_qud\u0026q=85\u0026s=3ba1c87384e113275374ebfbf55242a6","href":"https://archil.com"},"favicon":"https://mintcdn.com/regattastorage/S4_bUvKoVTjJKy3L/favicon.svg?fit=max\u0026auto=format\u0026n=S4_bUvKoVTjJKy3L\u0026q=85\u0026s=e2efc998ca3afaa27ef4036837d37349","background":{"color":{"dark":"#101011"}},"navbar":{"links":[{"href":"https://archil.com/pricing","label":"Pricing"},{"href":"mailto:support@archil.com","label":"Support"}],"primary":{"type":"button","label":"Console","href":"https://console.archil.com"}},"footer":{"socials":{"x":"https://x.com/archildata","linkedin":"https://linkedin.com/company/archil","discord":"https://discord.gg/KbXgvpWw7K"}},"seo":{"metatags":{"msvalidate.01":"EF0D87C55567AF7517BCE660F6318971"}},"integrations":{"posthog":{"apiKey":"phc_f4bRADnjXK5UboJFFUq9DIYClzzCl11Z4sdR5EM2UHE"}},"contextual":{"options":["copy","view","assistant","chatgpt","claude"],"display":"header"},"styling":{"latex":true},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"regattastorage","hasAudioNarration":false,"actualSubdomain":"regattastorage","customDomains":["docs.archil.com"],"gitSource":{"type":"github","owner":"archil-data","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"feedback":{"thumbs":true},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6af3623b65deb62b9182bccd","clientVersion":"0.0.4102","searchFilterCounts":[{"language":"default","tag":"Documentation","count":55},{"language":"default","tag":"API Reference","count":41},{"language":"default","tag":"Guides","count":26},{"language":"default","tag":"Reference","count":24},{"language":"default","tag":"Sandboxes","count":23},{"language":"default","tag":"Use Archil on other platforms","count":10},{"language":"default","tag":"Details","count":8},{"language":"default","tag":"Agents","count":8},{"language":"default","tag":"Disks","count":6},{"language":"default","tag":"Compute","count":6}]},"assistantConfig":{"deflection":{"enabled":true,"email":"support@archil.com","showHelpButton":true}},"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":"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":"custom.css","content":".dark #navbar div.dark\\:bg-gray-900{background-color:#1a1a1c}"}],"page":{"pagePath":"api-reference/sandboxes/start-sandbox","slug":"/api-reference/sandboxes/start-sandbox","pageMetadata":{"title":"Start Sandbox","openapi":"POST /api/sandboxes/{sid}/start","description":"Cold-boots from the persisted configuration and disks. If the sandbox\nwas paused, its memory snapshot is consumed and discarded before the\nnew VM runs; disk state remains. Without mount changes, starting a running\nsandbox or a pending cold start is idempotent. A sandbox that is stopping,\npausing, or pending a resume returns 409. Providing `mounts` replaces the\nadditional disk mounts for this and later sessions and requires an inactive\nsandbox; omit it to preserve saved mounts.\n","href":"/api-reference/sandboxes/start-sandbox"},"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: [\"Cold-boots from the persisted configuration and disks. If the sandbox\\nwas paused, its memory snapshot is consumed and discarded before the\\nnew VM runs; disk state remains. Without mount changes, starting a running\\nsandbox or a pending cold start is idempotent. A sandbox that is stopping,\\npausing, or pending a resume returns 409. Providing \", _jsx(_components.code, {\n children: \"mounts\"\n }), \" replaces the\\nadditional disk mounts for this and later sessions and requires an inactive\\nsandbox; omit it to preserve saved mounts.\"]\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Start Sandbox","openapi":"POST /api/sandboxes/{sid}/start","description":"Cold-boots from the persisted configuration and disks. If the sandbox\nwas paused, its memory snapshot is consumed and discarded before the\nnew VM runs; disk state remains. Without mount changes, starting a running\nsandbox or a pending cold start is idempotent. A sandbox that is stopping,\npausing, or pending a resume returns 409. Providing `mounts` replaces the\nadditional disk mounts for this and later sessions and requires an inactive\nsandbox; omit it to preserve saved mounts.\n","href":"/api-reference/sandboxes/start-sandbox"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":["/_mintlify/custom/regattastorage/7f4d365ae8e61637/rb2b.js"],"openApiReferenceData":{"operation":{"operationId":"startSandbox","summary":"Cold-start a sandbox","description":"Cold-boots from the persisted configuration and disks. If the sandbox\nwas paused, its memory snapshot is consumed and discarded before the\nnew VM runs; disk state remains. Without mount changes, starting a running\nsandbox or a pending cold start is idempotent. A sandbox that is stopping,\npausing, or pending a resume returns 409. Providing `mounts` replaces the\nadditional disk mounts for this and later sessions and requires an inactive\nsandbox; omit it to preserve saved mounts.\n","tags":["Sandboxes"],"parameters":["1ac87597-d40a-4f04-a811-42d96bb992a4","b0ddf80a-e629-4e9e-bf64-c39815fa409d"],"requestBody":"9922675d-8969-4b3c-8662-94c26cfb0126","responses":{"200":"2f1ce6da-ddd0-4414-903b-5eb2e1dc63fd","202":"b1b1df1c-9ab6-4c28-bc80-b65da841a828","400":"4ab76396-e6ed-43cf-870b-af6bcf42c395","401":"ead54b2d-2696-4462-bcac-63529ea29b7f","404":"e480c686-7ee1-46df-b73e-a7732cc613ba","409":"d5249dc3-0454-4c64-bfbf-04f62566b210","500":"e1ef1444-6204-4f93-b9c3-b7f7386e3927","503":"b4ad769c-1c51-447f-90f9-a6ddd86acc82","504":"6af9043c-ec01-4e60-b54a-3bb848dfbd00"},"method":"post","type":"path","servers":["b1342687-6cb8-4a7e-8bf7-37e1e6785396","ccc4eea5-2d5f-4c21-90b3-49f4e1a5c133","641e25ad-2e75-4766-9aee-dcccff02838a","6f0c44fb-45f8-42a1-b3f2-9c5e38dc6f60"],"security":["d4e1daaa-47eb-499e-9fff-d91128fbd239"],"path":"/api/sandboxes/{sid}/start","baseUrlOptions":["https://control.green.us-east-1.aws.prod.archil.com","https://control.green.eu-west-1.aws.prod.archil.com","https://control.green.us-west-2.aws.prod.archil.com","https://control.blue.us-central1.gcp.prod.archil.com"],"title":"Cold-start a sandbox","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"1ac87597-d40a-4f04-a811-42d96bb992a4":{"name":"sid","in":"path","required":true,"description":"Sandbox UUID","schema":{"type":"string","format":"uuid","isRequired":true,"description":"Sandbox UUID","uniqueKey":"","typeLabel":"string\u003cuuid>"}},"b0ddf80a-e629-4e9e-bf64-c39815fa409d":{"name":"wait","in":"query","required":false,"description":"Hold the request for a completed sandbox lifecycle transition","schema":{"type":"boolean","default":false,"isRequired":false,"description":"Hold the request for a completed sandbox lifecycle transition","uniqueKey":"","typeLabel":"boolean"}}},"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"mounts":{"type":"array","description":"Replace the sandbox's additional disk mounts for this and later sessions. Omit to keep the current ones; an empty list removes all additional mounts without deleting their disks. The internal root disk is unaffected. Not accepted by resume, and 409 while the sandbox is running or pending.","items":{"type":"object","required":["disk_id"],"properties":{"disk_id":{"type":"string","pattern":"^dsk-[0-9a-f]{16}$","description":"Existing disk owned by your account in the sandbox's region. A sandbox's internal root disk cannot be used here.","isRequired":true,"uniqueKey":"mounts.items.[INDEX].disk_id","typeLabel":"string"},"path":{"type":"string","description":"Absolute guest directory to mount at. Required when more than one disk is mounted; a sole mount defaults to /mnt/archil. Paths cannot overlap or contain whitespace, control characters, empty components, . or .. components, or a trailing slash. The root directory and guest system directories (/usr, /etc, /var, /opt, /dev, ...) and their descendants are reserved. A disk can be mounted once per sandbox.","uniqueKey":"mounts.items.[INDEX].path","typeLabel":"string"},"subdirectory":{"type":"string","description":"Relative subdirectory of the disk to expose instead of its root.","uniqueKey":"mounts.items.[INDEX].subdirectory","typeLabel":"string"},"read_only":{"type":"boolean","default":false,"uniqueKey":"mounts.items.[INDEX].read_only","typeLabel":"boolean"},"conditional":{"type":"boolean","default":false,"description":"Mount in conditional mode, which lets this mount write to the disk without a delegation checkout, allowing concurrent writers.","uniqueKey":"mounts.items.[INDEX].conditional","typeLabel":"boolean"},"queue_ms":{"type":"integer","minimum":1,"description":"Milliseconds to wait for the disk's exclusive root delegation before the mount fails. Not allowed with read_only or conditional.","uniqueKey":"mounts.items.[INDEX].queue_ms","typeLabel":"integer"}},"uniqueKey":"mounts.items.[INDEX]","typeLabel":"object"},"uniqueKey":"mounts","typeLabel":"object[]"}},"uniqueKey":"","typeLabel":"object"},"example":{"mounts":[{"disk_id":"dsk-0123456789abcdef","path":"/mnt/archil"}]},"examples":{"Example":{"title":"Example","value":{"mounts":[{"disk_id":"dsk-0123456789abcdef","path":"/mnt/archil"}]}}},"exampleType":"examples"}},"exampleType":"examples"},"responses":{"2f1ce6da-ddd0-4414-903b-5eb2e1dc63fd":{"description":"The sandbox is running","content":{"application/json":{"schema":{"type":"object","required":["success","data"],"properties":{"success":{"type":"boolean","example":true,"isRequired":true,"uniqueKey":"success","typeLabel":"boolean"},"data":{"type":"object","required":["sandbox_id","name","status","vcpu_count","mem_size_mib","max_ttl_seconds","idle_ttl_seconds","max_concurrent_execs","base_image","created_at","last_active_at"],"properties":{"sandbox_id":{"type":"string","format":"uuid","isRequired":true,"uniqueKey":"data.sandbox_id","typeLabel":"string\u003cuuid>"},"name":{"type":"string","minLength":1,"maxLength":63,"pattern":"^[a-z0-9]([-a-z0-9]*[a-z0-9])?$","description":"Sandbox name.","isRequired":true,"uniqueKey":"data.name","typeLabel":"string"},"status":{"type":"string","enum":["pending","running","pausing","paused","stopping","stopped","exited","failed","deleting","deleted"],"isRequired":true,"uniqueKey":"data.status","typeLabel":"enum\u003cstring>"},"vcpu_count":{"type":"integer","isRequired":true,"uniqueKey":"data.vcpu_count","typeLabel":"integer"},"mem_size_mib":{"type":"integer","isRequired":true,"uniqueKey":"data.mem_size_mib","typeLabel":"integer"},"max_ttl_seconds":{"type":"integer","description":"Lifetime budget applied independently to each powered-on session. Expiry pauses the sandbox, preserving memory and processes for resume. Defaults to 24 hours. Timeout resets cannot extend a session beyond 24 hours.","isRequired":true,"uniqueKey":"data.max_ttl_seconds","typeLabel":"integer"},"idle_ttl_seconds":{"type":"integer","description":"Seconds without a direct process connection before the sandbox pauses, preserving memory and processes for resume. Zero disables idle expiry.","isRequired":true,"uniqueKey":"data.idle_ttl_seconds","typeLabel":"integer"},"max_concurrent_execs":{"type":"integer","description":"Maximum number of concurrently attached process sessions. Detached processes and one-shot process controls do not count.","isRequired":true,"uniqueKey":"data.max_concurrent_execs","typeLabel":"integer"},"base_image":{"type":"string","description":"OCI reference requested when the sandbox was created. Empty for a sandbox created from `image_id`.","isRequired":true,"uniqueKey":"data.base_image","typeLabel":"string"},"created_at":{"type":"string","format":"date-time","isRequired":true,"uniqueKey":"data.created_at","typeLabel":"string\u003cdate-time>"},"last_active_at":{"type":"string","format":"date-time","isRequired":true,"uniqueKey":"data.last_active_at","typeLabel":"string\u003cdate-time>"},"image_digest":{"type":"string","description":"Image digest the sandbox was created from, if any.","uniqueKey":"data.image_digest","typeLabel":"string"},"platform":{"type":"string","enum":["amd64"],"description":"Sandbox CPU architecture. Archil's public sandbox service runs on amd64. This response field is not a creation option; callers cannot select an architecture per sandbox.","uniqueKey":"data.platform","typeLabel":"enum\u003cstring>"},"endpoints":{"type":"array","description":"Public hostnames published by enabled sandbox services.","items":{"type":"object","required":["port","hostname"],"properties":{"port":{"type":"integer","minimum":1,"maximum":65535,"isRequired":true,"uniqueKey":"data.endpoints.items.[INDEX].port","typeLabel":"integer"},"hostname":{"type":"string","isRequired":true,"uniqueKey":"data.endpoints.items.[INDEX].hostname","typeLabel":"string"}},"uniqueKey":"data.endpoints.items.[INDEX]","typeLabel":"object"},"uniqueKey":"data.endpoints","typeLabel":"object[]"},"enable_service_ingress":{"type":"boolean","default":false,"description":"Whether services inside the sandbox can expose ingress. Explicit API port exposure remains available regardless of this setting.","uniqueKey":"data.enable_service_ingress","typeLabel":"boolean"},"mounts":{"type":"array","items":{"type":"object","required":["disk_id"],"properties":{"disk_id":{"type":"string","pattern":"^dsk-[0-9a-f]{16}$","description":"Existing disk owned by your account in the sandbox's region. A sandbox's internal root disk cannot be used here.","isRequired":true,"uniqueKey":"data.mounts.items.[INDEX].disk_id","typeLabel":"string"},"path":{"type":"string","description":"Absolute guest directory to mount at. Required when more than one disk is mounted; a sole mount defaults to /mnt/archil. Paths cannot overlap or contain whitespace, control characters, empty components, . or .. components, or a trailing slash. The root directory and guest system directories (/usr, /etc, /var, /opt, /dev, ...) and their descendants are reserved. A disk can be mounted once per sandbox.","uniqueKey":"data.mounts.items.[INDEX].path","typeLabel":"string"},"subdirectory":{"type":"string","description":"Relative subdirectory of the disk to expose instead of its root.","uniqueKey":"data.mounts.items.[INDEX].subdirectory","typeLabel":"string"},"read_only":{"type":"boolean","default":false,"uniqueKey":"data.mounts.items.[INDEX].read_only","typeLabel":"boolean"},"conditional":{"type":"boolean","default":false,"description":"Mount in conditional mode, which lets this mount write to the disk without a delegation checkout, allowing concurrent writers.","uniqueKey":"data.mounts.items.[INDEX].conditional","typeLabel":"boolean"},"queue_ms":{"type":"integer","minimum":1,"description":"Milliseconds to wait for the disk's exclusive root delegation before the mount fails. Not allowed with read_only or conditional.","uniqueKey":"data.mounts.items.[INDEX].queue_ms","typeLabel":"integer"}},"uniqueKey":"data.mounts.items.[INDEX]","typeLabel":"object"},"uniqueKey":"data.mounts","typeLabel":"object[]"},"running_at":{"type":"string","format":"date-time","uniqueKey":"data.running_at","typeLabel":"string\u003cdate-time>"},"finished_at":{"type":"string","format":"date-time","uniqueKey":"data.finished_at","typeLabel":"string\u003cdate-time>"},"exit_reason":{"type":"string","uniqueKey":"data.exit_reason","typeLabel":"string"},"checkpoint":{"type":"string","description":"Disk checkpoint the current session leaves behind. Present while\npausing, paused, stopping, or stopped, and committed once the\nsandbox is paused or stopped. Pass it to the fork endpoint to fork\nexactly this state.\n","uniqueKey":"data.checkpoint","typeLabel":"string"}},"isRequired":true,"uniqueKey":"data","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"example":{"success":true,"data":{"sandbox_id":"019d158e-7100-7000-8000-0123456789ab","name":"agent-workspace","status":"running","vcpu_count":2,"mem_size_mib":4096,"max_ttl_seconds":86400,"idle_ttl_seconds":0,"max_concurrent_execs":32,"enable_service_ingress":false,"base_image":"python:3.13","mounts":[{"disk_id":"dsk-0123456789abcdef","path":"/mnt/archil"}],"created_at":"2026-10-06T12:00:00Z","last_active_at":"2026-10-06T12:00:05Z","running_at":"2026-10-06T12:00:05Z"}},"examples":{"Example":{"title":"Example","value":{"success":true,"data":{"sandbox_id":"019d158e-7100-7000-8000-0123456789ab","name":"agent-workspace","status":"running","vcpu_count":2,"mem_size_mib":4096,"max_ttl_seconds":86400,"idle_ttl_seconds":0,"max_concurrent_execs":32,"enable_service_ingress":false,"base_image":"python:3.13","mounts":[{"disk_id":"dsk-0123456789abcdef","path":"/mnt/archil"}],"created_at":"2026-10-06T12:00:00Z","last_active_at":"2026-10-06T12:00:05Z","running_at":"2026-10-06T12:00:05Z"}}}},"exampleType":"examples"}},"exampleType":"examples"},"b1b1df1c-9ab6-4c28-bc80-b65da841a828":{"description":"The sandbox start is pending","content":{"application/json":{"schema":{"type":"object","required":["success","data"],"properties":{"success":{"type":"boolean","example":true,"isRequired":true,"uniqueKey":"success","typeLabel":"boolean"},"data":{"type":"object","required":["sandbox_id","name","status","vcpu_count","mem_size_mib","max_ttl_seconds","idle_ttl_seconds","max_concurrent_execs","base_image","created_at","last_active_at"],"properties":{"sandbox_id":{"type":"string","format":"uuid","isRequired":true,"uniqueKey":"data.sandbox_id","typeLabel":"string\u003cuuid>"},"name":{"type":"string","minLength":1,"maxLength":63,"pattern":"^[a-z0-9]([-a-z0-9]*[a-z0-9])?$","description":"Sandbox name.","isRequired":true,"uniqueKey":"data.name","typeLabel":"string"},"status":{"type":"string","enum":["pending","running","pausing","paused","stopping","stopped","exited","failed","deleting","deleted"],"isRequired":true,"uniqueKey":"data.status","typeLabel":"enum\u003cstring>"},"vcpu_count":{"type":"integer","isRequired":true,"uniqueKey":"data.vcpu_count","typeLabel":"integer"},"mem_size_mib":{"type":"integer","isRequired":true,"uniqueKey":"data.mem_size_mib","typeLabel":"integer"},"max_ttl_seconds":{"type":"integer","description":"Lifetime budget applied independently to each powered-on session. Expiry pauses the sandbox, preserving memory and processes for resume. Defaults to 24 hours. Timeout resets cannot extend a session beyond 24 hours.","isRequired":true,"uniqueKey":"data.max_ttl_seconds","typeLabel":"integer"},"idle_ttl_seconds":{"type":"integer","description":"Seconds without a direct process connection before the sandbox pauses, preserving memory and processes for resume. Zero disables idle expiry.","isRequired":true,"uniqueKey":"data.idle_ttl_seconds","typeLabel":"integer"},"max_concurrent_execs":{"type":"integer","description":"Maximum number of concurrently attached process sessions. Detached processes and one-shot process controls do not count.","isRequired":true,"uniqueKey":"data.max_concurrent_execs","typeLabel":"integer"},"base_image":{"type":"string","description":"OCI reference requested when the sandbox was created. Empty for a sandbox created from `image_id`.","isRequired":true,"uniqueKey":"data.base_image","typeLabel":"string"},"created_at":{"type":"string","format":"date-time","isRequired":true,"uniqueKey":"data.created_at","typeLabel":"string\u003cdate-time>"},"last_active_at":{"type":"string","format":"date-time","isRequired":true,"uniqueKey":"data.last_active_at","typeLabel":"string\u003cdate-time>"},"image_digest":{"type":"string","description":"Image digest the sandbox was created from, if any.","uniqueKey":"data.image_digest","typeLabel":"string"},"platform":{"type":"string","enum":["amd64"],"description":"Sandbox CPU architecture. Archil's public sandbox service runs on amd64. This response field is not a creation option; callers cannot select an architecture per sandbox.","uniqueKey":"data.platform","typeLabel":"enum\u003cstring>"},"endpoints":{"type":"array","description":"Public hostnames published by enabled sandbox services.","items":{"type":"object","required":["port","hostname"],"properties":{"port":{"type":"integer","minimum":1,"maximum":65535,"isRequired":true,"uniqueKey":"data.endpoints.items.[INDEX].port","typeLabel":"integer"},"hostname":{"type":"string","isRequired":true,"uniqueKey":"data.endpoints.items.[INDEX].hostname","typeLabel":"string"}},"uniqueKey":"data.endpoints.items.[INDEX]","typeLabel":"object"},"uniqueKey":"data.endpoints","typeLabel":"object[]"},"enable_service_ingress":{"type":"boolean","default":false,"description":"Whether services inside the sandbox can expose ingress. Explicit API port exposure remains available regardless of this setting.","uniqueKey":"data.enable_service_ingress","typeLabel":"boolean"},"mounts":{"type":"array","items":{"type":"object","required":["disk_id"],"properties":{"disk_id":{"type":"string","pattern":"^dsk-[0-9a-f]{16}$","description":"Existing disk owned by your account in the sandbox's region. A sandbox's internal root disk cannot be used here.","isRequired":true,"uniqueKey":"data.mounts.items.[INDEX].disk_id","typeLabel":"string"},"path":{"type":"string","description":"Absolute guest directory to mount at. Required when more than one disk is mounted; a sole mount defaults to /mnt/archil. Paths cannot overlap or contain whitespace, control characters, empty components, . or .. components, or a trailing slash. The root directory and guest system directories (/usr, /etc, /var, /opt, /dev, ...) and their descendants are reserved. A disk can be mounted once per sandbox.","uniqueKey":"data.mounts.items.[INDEX].path","typeLabel":"string"},"subdirectory":{"type":"string","description":"Relative subdirectory of the disk to expose instead of its root.","uniqueKey":"data.mounts.items.[INDEX].subdirectory","typeLabel":"string"},"read_only":{"type":"boolean","default":false,"uniqueKey":"data.mounts.items.[INDEX].read_only","typeLabel":"boolean"},"conditional":{"type":"boolean","default":false,"description":"Mount in conditional mode, which lets this mount write to the disk without a delegation checkout, allowing concurrent writers.","uniqueKey":"data.mounts.items.[INDEX].conditional","typeLabel":"boolean"},"queue_ms":{"type":"integer","minimum":1,"description":"Milliseconds to wait for the disk's exclusive root delegation before the mount fails. Not allowed with read_only or conditional.","uniqueKey":"data.mounts.items.[INDEX].queue_ms","typeLabel":"integer"}},"uniqueKey":"data.mounts.items.[INDEX]","typeLabel":"object"},"uniqueKey":"data.mounts","typeLabel":"object[]"},"running_at":{"type":"string","format":"date-time","uniqueKey":"data.running_at","typeLabel":"string\u003cdate-time>"},"finished_at":{"type":"string","format":"date-time","uniqueKey":"data.finished_at","typeLabel":"string\u003cdate-time>"},"exit_reason":{"type":"string","uniqueKey":"data.exit_reason","typeLabel":"string"},"checkpoint":{"type":"string","description":"Disk checkpoint the current session leaves behind. Present while\npausing, paused, stopping, or stopped, and committed once the\nsandbox is paused or stopped. Pass it to the fork endpoint to fork\nexactly this state.\n","uniqueKey":"data.checkpoint","typeLabel":"string"}},"isRequired":true,"uniqueKey":"data","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"example":{"success":true,"data":{"sandbox_id":"019d158e-7100-7000-8000-0123456789ab","name":"agent-workspace","status":"pending","vcpu_count":2,"mem_size_mib":4096,"max_ttl_seconds":86400,"idle_ttl_seconds":0,"max_concurrent_execs":32,"enable_service_ingress":false,"base_image":"python:3.13","mounts":[{"disk_id":"dsk-0123456789abcdef","path":"/mnt/archil"}],"created_at":"2026-10-06T12:00:00Z","last_active_at":"2026-10-06T12:00:00Z"}},"examples":{"Example":{"title":"Example","value":{"success":true,"data":{"sandbox_id":"019d158e-7100-7000-8000-0123456789ab","name":"agent-workspace","status":"pending","vcpu_count":2,"mem_size_mib":4096,"max_ttl_seconds":86400,"idle_ttl_seconds":0,"max_concurrent_execs":32,"enable_service_ingress":false,"base_image":"python:3.13","mounts":[{"disk_id":"dsk-0123456789abcdef","path":"/mnt/archil"}],"created_at":"2026-10-06T12:00:00Z","last_active_at":"2026-10-06T12:00:00Z"}}}},"exampleType":"examples"}},"exampleType":"examples"},"4ab76396-e6ed-43cf-870b-af6bcf42c395":{"description":"Invalid request body or parameters","content":{"application/json":{"schema":{"type":"object","required":["success","error"],"properties":{"success":{"type":"boolean","example":false,"isRequired":true,"uniqueKey":"success","typeLabel":"boolean"},"error":{"type":"string","example":"Invalid request parameters","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"code":{"type":"string","description":"Stable machine-readable error code.","uniqueKey":"code","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"example":{"success":false,"error":"Invalid request body","code":"bad_request"},"examples":{"Example":{"title":"Example","value":{"success":false,"error":"Invalid request body","code":"bad_request"}}},"exampleType":"examples"}},"exampleType":"examples"},"ead54b2d-2696-4462-bcac-63529ea29b7f":{"description":"Missing or invalid authentication credentials","content":{"text/plain":{"schema":{"type":"string","uniqueKey":"","typeLabel":"string"},"examples":{"missingAuthorization":{"title":"missingAuthorization","value":"Must provide an Authorization header"},"invalidCredentials":{"title":"invalidCredentials","value":"Unauthorized"}},"exampleType":"examples"}},"exampleType":"examples"},"e480c686-7ee1-46df-b73e-a7732cc613ba":{"description":"Sandbox or mount disk not found or not accessible to this account","content":{"application/json":{"schema":{"type":"object","required":["success","error"],"properties":{"success":{"type":"boolean","example":false,"isRequired":true,"uniqueKey":"success","typeLabel":"boolean"},"error":{"type":"string","example":"Invalid request parameters","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"code":{"type":"string","description":"Stable machine-readable error code.","uniqueKey":"code","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"sandboxNotFound":{"title":"sandboxNotFound","value":{"success":false,"error":"Sandbox not found","code":"not_found"}},"diskNotFound":{"title":"diskNotFound","value":{"success":false,"error":"mounts[0]: disk dsk-0123456789abcdef not found","code":"not_found"}}},"exampleType":"examples"}},"exampleType":"examples"},"d5249dc3-0454-4c64-bfbf-04f62566b210":{"description":"Sandbox is stopping, pausing, being deleted, or resuming; mount changes also conflict with a running or pending session","content":{"application/json":{"schema":{"type":"object","required":["success","error"],"properties":{"success":{"type":"boolean","example":false,"isRequired":true,"uniqueKey":"success","typeLabel":"boolean"},"error":{"type":"string","example":"Invalid request parameters","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"code":{"type":"string","description":"Stable machine-readable error code.","uniqueKey":"code","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"mountsWhileActive":{"title":"mountsWhileActive","value":{"success":false,"error":"mounts can only change on a cold start of an inactive sandbox","code":"sandbox_mounts_while_active"}},"stopping":{"title":"stopping","value":{"success":false,"error":"Sandbox is still stopping; retry once it is stopped","code":"sandbox_stopping"}},"pausing":{"title":"pausing","value":{"success":false,"error":"Sandbox is still pausing; retry once it is paused","code":"sandbox_pausing"}},"startConflict":{"title":"startConflict","value":{"success":false,"error":"Sandbox is already starting with a different lifecycle intent","code":"sandbox_start_conflict"}},"terminated":{"title":"terminated","value":{"success":false,"error":"Sandbox is no longer accepting requests","code":"sandbox_terminated"}}},"exampleType":"examples"}},"exampleType":"examples"},"e1ef1444-6204-4f93-b9c3-b7f7386e3927":{"description":"Internal server error","content":{"application/json":{"schema":{"type":"object","required":["success","error"],"properties":{"success":{"type":"boolean","example":false,"isRequired":true,"uniqueKey":"success","typeLabel":"boolean"},"error":{"type":"string","example":"Invalid request parameters","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"code":{"type":"string","description":"Stable machine-readable error code.","uniqueKey":"code","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"example":{"success":false,"error":"Internal error processing sandbox request","code":"internal_server_error"},"examples":{"Example":{"title":"Example","value":{"success":false,"error":"Internal error processing sandbox request","code":"internal_server_error"}}},"exampleType":"examples"}},"exampleType":"examples"},"b4ad769c-1c51-447f-90f9-a6ddd86acc82":{"description":"Sandbox capacity or runtime temporarily unavailable, or sandboxes are disabled","content":{"application/json":{"schema":{"type":"object","required":["success","error"],"properties":{"success":{"type":"boolean","example":false,"isRequired":true,"uniqueKey":"success","typeLabel":"boolean"},"error":{"type":"string","example":"Invalid request parameters","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"code":{"type":"string","description":"Stable machine-readable error code.","uniqueKey":"code","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"noCapacity":{"title":"noCapacity","value":{"success":false,"error":"No sandbox capacity is available; retry","code":"no_capacity"}},"runtimeRetryable":{"title":"runtimeRetryable","value":{"success":false,"error":"Sandbox lifecycle request is temporarily blocked; retry","code":"runtime_retryable"}},"notEnabled":{"title":"notEnabled","value":{"success":false,"error":"Sandboxes are not enabled on this controlplane","code":"not_enabled"}}},"exampleType":"examples"}},"exampleType":"examples"},"6af9043c-ec01-4e60-b54a-3bb848dfbd00":{"description":"Request timed out; retry","content":{"application/json":{"schema":{"type":"object","required":["success","error"],"properties":{"success":{"type":"boolean","example":false,"isRequired":true,"uniqueKey":"success","typeLabel":"boolean"},"error":{"type":"string","example":"Invalid request parameters","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"code":{"type":"string","description":"Stable machine-readable error code.","uniqueKey":"code","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"example":{"success":false,"error":"Sandbox request timed out; retry","code":"timeout"},"examples":{"Example":{"title":"Example","value":{"success":false,"error":"Sandbox request timed out; retry","code":"timeout"}}},"exampleType":"examples"}},"exampleType":"examples"}},"security":{"d4e1daaa-47eb-499e-9fff-d91128fbd239":{"ApiKeyAuth":{"type":"http","scheme":"bearer","description":"Archil API key, including its `key-` prefix","scopes":[],"schemeName":"ApiKeyAuth"}}},"servers":{"b1342687-6cb8-4a7e-8bf7-37e1e6785396":{"url":"https://control.green.us-east-1.aws.prod.archil.com","description":"AWS US East (N. Virginia) — aws-us-east-1"},"ccc4eea5-2d5f-4c21-90b3-49f4e1a5c133":{"url":"https://control.green.eu-west-1.aws.prod.archil.com","description":"AWS EU West (Ireland) — aws-eu-west-1"},"641e25ad-2e75-4766-9aee-dcccff02838a":{"url":"https://control.green.us-west-2.aws.prod.archil.com","description":"AWS US West (Oregon) — aws-us-west-2"},"6f0c44fb-45f8-42a1-b3f2-9c5e38dc6f60":{"url":"https://control.blue.us-central1.gcp.prod.archil.com","description":"GCP US Central (Iowa) — gcp-us-central1"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","description":"Archil API key, including its `key-` prefix","scopes":[],"schemeName":"ApiKeyAuth"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Archil API key, including its `key-` prefix","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"ApiKeyAuth","name":"Authorization"}],"title":"ApiKeyAuth"}]},"originalFileLocation":"api-reference/openapi.yaml"},"subdomain":"regattastorage","siteName":"Archil","title":"Start Sandbox - Archil","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-08T17:15:59.958Z","originalFileLocation":"api-reference/sandboxes/start-sandbox.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=\"Cold-boots from the persisted configuration and disks. If the sandbox was paused, its memory snapshot is consumed and discarded before the new VM runs; disk state remains. Without mount changes, starting a running sandbox or a pending cold start is idempotent. A sandbox that is stopping, pausing, or pending a resume returns 409. Providing mounts replaces the additional disk mounts for this and later sessions and requires an inactive sandbox; omit it to preserve saved mounts.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Archil\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/regattastorage/2Y7S3E06tG_mFVFw/_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/regattastorage/2Y7S3E06tG_mFVFw/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/regattastorage/2Y7S3E06tG_mFVFw/_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/regattastorage/2Y7S3E06tG_mFVFw/_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/regattastorage/2Y7S3E06tG_mFVFw/_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/regattastorage/2Y7S3E06tG_mFVFw/_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/regattastorage/2Y7S3E06tG_mFVFw/_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/regattastorage/2Y7S3E06tG_mFVFw/_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/regattastorage/2Y7S3E06tG_mFVFw/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Start Sandbox - Archil\">\u003cmeta data-mint-head property=\"og:description\" content=\"Cold-boots from the persisted configuration and disks. If the sandbox was paused, its memory snapshot is consumed and discarded before the new VM runs; disk state remains. Without mount changes, starting a running sandbox or a pending cold start is idempotent. A sandbox that is stopping, pausing, or pending a resume returns 409. Providing mounts replaces the additional disk mounts for this and later sessions and requires an inactive sandbox; omit it to preserve saved mounts.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Archil\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.archil.com/api-reference/sandboxes/start-sandbox\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://regattastorage.mintlify.site/_mintlify/api/og/v2?division=Sandboxes\u0026amp;title=Start+Sandbox\u0026amp;description=Cold-boots+from+the+persisted+configuration+and+disks.+If+the+sandbox%0Awas+paused%2C+its+memory+snapshot+is+consumed+and+discarded+before+the%0Anew+VM+runs%3B+disk+sta\u0026amp;theme=f9cc175363129fdea211f9f4\u0026amp;signature=52a1abcaa586c16289932358b1f4fa0d131f72b42c67c06103115260d42c094a\">\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=\"Start Sandbox - Archil\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Cold-boots from the persisted configuration and disks. If the sandbox was paused, its memory snapshot is consumed and discarded before the new VM runs; disk state remains. Without mount changes, starting a running sandbox or a pending cold start is idempotent. A sandbox that is stopping, pausing, or pending a resume returns 409. Providing mounts replaces the additional disk mounts for this and later sessions and requires an inactive sandbox; omit it to preserve saved mounts.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://regattastorage.mintlify.site/_mintlify/api/og/v2?division=Sandboxes\u0026amp;title=Start+Sandbox\u0026amp;description=Cold-boots+from+the+persisted+configuration+and+disks.+If+the+sandbox%0Awas+paused%2C+its+memory+snapshot+is+consumed+and+discarded+before+the%0Anew+VM+runs%3B+disk+sta\u0026amp;theme=f9cc175363129fdea211f9f4\u0026amp;signature=52a1abcaa586c16289932358b1f4fa0d131f72b42c67c06103115260d42c094a\">\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/regattastorage/2Y7S3E06tG_mFVFw/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Archil\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#CA5550\">\u003cmeta data-mint-head name=\"msvalidate.01\" content=\"EF0D87C55567AF7517BCE660F6318971\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.archil.com/api-reference/sandboxes/start-sandbox\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/sandboxes/start-sandbox.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.archil.com/#organization\",\"name\":\"Archil\",\"url\":\"https://docs.archil.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/regattastorage/ZgodyIZMQ_rX_qud/logo/archil-black-fullbleed.svg?fit=max\u0026auto=format\u0026n=ZgodyIZMQ_rX_qud\u0026q=85\u0026s=adba0f4983e37336b24452e3ba977724\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.archil.com#website\",\"name\":\"Archil\",\"url\":\"https://docs.archil.com\",\"publisher\":{\"@id\":\"https://docs.archil.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.archil.com/api-reference/sandboxes/start-sandbox#webpage\",\"url\":\"https://docs.archil.com/api-reference/sandboxes/start-sandbox\",\"name\":\"Start Sandbox\",\"description\":\"Cold-boots from the persisted configuration and disks. If the sandbox was paused, its memory snapshot is consumed and discarded before the new VM runs; disk state remains. Without mount changes, starting a running sandbox or a pending cold start is idempotent. A sandbox that is stopping, pausing, or pending a resume returns 409. Providing mounts replaces the additional disk mounts for this and later sessions and requires an inactive sandbox; omit it to preserve saved mounts.\",\"dateModified\":\"2026-10-08T17:15:59.958Z\",\"isPartOf\":{\"@id\":\"https://docs.archil.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.archil.com/api-reference/sandboxes/start-sandbox#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.archil.com/api-reference/sandboxes/start-sandbox#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Sandboxes\",\"item\":\"https://docs.archil.com/api-reference/sandboxes/list-sandboxes\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Start Sandbox\",\"item\":\"https://docs.archil.com/api-reference/sandboxes/start-sandbox\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.archil.com/api-reference/sandboxes/start-sandbox#apireference\",\"headline\":\"Start Sandbox\",\"name\":\"Start Sandbox\",\"description\":\"Cold-boots from the persisted configuration and disks. If the sandbox was paused, its memory snapshot is consumed and discarded before the new VM runs; disk state remains. Without mount changes, starting a running sandbox or a pending cold start is idempotent. A sandbox that is stopping, pausing, or pending a resume returns 409. Providing mounts replaces the additional disk mounts for this and later sessions and requires an inactive sandbox; omit it to preserve saved mounts.\",\"url\":\"https://docs.archil.com/api-reference/sandboxes/start-sandbox\",\"mainEntityOfPage\":{\"@id\":\"https://docs.archil.com/api-reference/sandboxes/start-sandbox#webpage\"},\"dateModified\":\"2026-10-08T17:15:59.958Z\",\"publisher\":{\"@id\":\"https://docs.archil.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.archil.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Archil\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Archil\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/api-reference/sandboxes/start-sandbox.md","siteName":"Archil","nav":{"global":null,"tabs":[{"tab":"Documentation","pages":[{"title":"Documentation","href":"/getting-started/introduction"}]},{"tab":"API Reference","groups":[{"group":"Overview","pages":[{"title":"API Reference","href":"/api-reference/introduction"}]},{"group":"Disks","pages":[{"title":"List Disks","openapi":"GET /api/disks","href":"/api-reference/disks/list-disks"},{"title":"Create Disk","openapi":"POST /api/disks","href":"/api-reference/disks/create-disk"},{"title":"Get Disk","openapi":"GET /api/disks/{id}","href":"/api-reference/disks/get-disk"},{"title":"Delete Disk","openapi":"DELETE /api/disks/{id}","href":"/api-reference/disks/delete-disk"},{"title":"Create Share URL","openapi":"POST /api/disks/{id}/share","href":"/api-reference/disks/create-share-url"},{"title":"Prefetch File Ranges","openapi":"POST /api/disks/{id}/prefetch","href":"/api-reference/disks/prefetch-disk"}]},{"group":"Serverless Execution","pages":[{"title":"Execute Command on Disk","openapi":"POST /api/disks/{id}/exec","href":"/api-reference/serverless-execution/exec-disk"},{"title":"Execute Command with Multiple Disks","openapi":"POST /api/exec","href":"/api-reference/serverless-execution/exec-multi"},{"title":"Search Files (grep)","sidebarTitle":"Search Files","openapi":"POST /api/disks/{id}/grep","href":"/api-reference/serverless-execution/grep-disk"}]},{"group":"Sandboxes","pages":[{"title":"List Sandboxes","openapi":"GET /api/sandboxes","href":"/api-reference/sandboxes/list-sandboxes"},{"title":"Create Sandbox","openapi":"POST /api/sandboxes","href":"/api-reference/sandboxes/create-sandbox"},{"title":"Get Sandbox","openapi":"GET /api/sandboxes/{sid}","href":"/api-reference/sandboxes/get-sandbox"},{"title":"Get Sandbox Usage","openapi":"GET /api/sandboxes/{sid}/usage","href":"/api-reference/sandboxes/get-sandbox-usage"},{"title":"Delete Sandbox","openapi":"DELETE /api/sandboxes/{sid}","href":"/api-reference/sandboxes/delete-sandbox"},{"title":"Create Sandbox Connection","openapi":"POST /api/sandboxes/{sid}/connections","href":"/api-reference/sandboxes/create-sandbox-connection"},{"title":"Set Sandbox Timeouts","openapi":"POST /api/sandboxes/{sid}/timeout","href":"/api-reference/sandboxes/set-sandbox-timeout"},{"title":"List Sandbox Ports","openapi":"GET /api/sandboxes/{sid}/ports","href":"/api-reference/sandboxes/list-sandbox-ports"},{"title":"Expose Sandbox Port","openapi":"PUT /api/sandboxes/{sid}/ports/{port}","href":"/api-reference/sandboxes/expose-sandbox-port"},{"title":"Unexpose Sandbox Port","openapi":"DELETE /api/sandboxes/{sid}/ports/{port}","href":"/api-reference/sandboxes/unexpose-sandbox-port"},{"title":"List Sandbox Port Tokens","openapi":"GET /api/sandboxes/{sid}/port-tokens","href":"/api-reference/sandboxes/list-sandbox-port-tokens"},{"title":"Create Sandbox Port Token","openapi":"POST /api/sandboxes/{sid}/port-tokens","href":"/api-reference/sandboxes/create-sandbox-port-token"},{"title":"Get Sandbox Port Token","openapi":"GET /api/sandboxes/{sid}/port-tokens/{token_id}","href":"/api-reference/sandboxes/get-sandbox-port-token"},{"title":"Delete Sandbox Port Token","openapi":"DELETE /api/sandboxes/{sid}/port-tokens/{token_id}","href":"/api-reference/sandboxes/delete-sandbox-port-token"},{"title":"Get Sandbox Network","openapi":"GET /api/sandboxes/{sid}/network","href":"/api-reference/sandboxes/get-sandbox-network"},{"title":"Update Sandbox Network","openapi":"PUT /api/sandboxes/{sid}/network","href":"/api-reference/sandboxes/update-sandbox-network"},{"title":"Pause Sandbox","openapi":"POST /api/sandboxes/{sid}/pause","href":"/api-reference/sandboxes/pause-sandbox"},{"title":"Fork Sandbox","openapi":"POST /api/sandboxes/{sid}/fork","href":"/api-reference/sandboxes/fork-sandbox"},{"title":"Resume Sandbox","openapi":"POST /api/sandboxes/{sid}/resume","description":"Restores a paused sandbox's committed CPU and memory snapshot.\nResuming a running sandbox or a pending resume is idempotent. Only a\n`paused` sandbox can begin a new resume; `stopped`, `exited`, `failed`,\n`stopping`, `pausing`, or a pending cold start returns 409.\n","href":"/api-reference/sandboxes/resume-sandbox"},{"title":"Start Sandbox","openapi":"POST /api/sandboxes/{sid}/start","href":"/api-reference/sandboxes/start-sandbox"},{"title":"Stop Sandbox","openapi":"POST /api/sandboxes/{sid}/stop","description":"Gracefully shuts down the guest, then checkpoints its disk before\nentering `stopped`. The sandbox and any forks from it cold-boot from\ndisk state. Stopping a paused sandbox reuses its existing disk\ncheckpoint. In-flight processes receive the guest shutdown signal.\n","href":"/api-reference/sandboxes/stop-sandbox"},{"title":"Build Image","openapi":"POST /api/images","href":"/api-reference/images/build-image"},{"title":"Get Image","openapi":"GET /api/images/{image_id}","href":"/api-reference/images/get-image"}]},{"group":"Disk Users","pages":[{"title":"Add Disk User","openapi":"POST /api/disks/{id}/users","href":"/api-reference/disk-users/add-user"},{"title":"Remove Disk User","openapi":"DELETE /api/disks/{id}/users/{userType}","href":"/api-reference/disk-users/remove-user"}]},{"group":"API Tokens","pages":[{"title":"List API Tokens","openapi":"GET /api/tokens","href":"/api-reference/tokens/list-tokens"},{"title":"Create API Token","openapi":"POST /api/tokens","href":"/api-reference/tokens/create-token"},{"title":"Delete API Token","openapi":"DELETE /api/tokens/{id}","href":"/api-reference/tokens/delete-token"}]},{"group":"Billing","pages":[{"title":"Get Subscription","openapi":"GET /api/billing/subscription","href":"/api-reference/billing/get-subscription"},{"title":"Get Usage","openapi":"GET /api/billing/usage","href":"/api-reference/billing/get-usage"},{"title":"Get Summary","openapi":"GET /api/billing/summary","href":"/api-reference/billing/get-summary"}]}]},{"tab":"Guides","pages":[{"title":"Guides","href":"/guides/agents/coding-agent"}]}]},"basePath":"","title":"Start Sandbox - Archil","buildId":"dpl_596ePT575z4qnAFksq1biRW97aLY","deploymentId":"dpl_596ePT575z4qnAFksq1biRW97aLY","dynamics":["c2aa737661","b0f84f53ff","a9bb46feb3","2b790eda92"],"chunks":["OpenApiReferenceProvider-C9Wu0MeN.js","utils-jWgu-6Qf.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-DBD8f9qn.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-BGuX1ui5.js","snippetPresets-Evy63nQB.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","Page-D6S0Yh6q.js","ApiExamples-BQHO1lnV.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-B6C8m-t_.js","shallow-BG4cT0fH.js","getApiPlaygroundDisplay-CgEPrE-D.js","CodeSnippet-CU8JyZ9N.js","CodeSnippets-BnxHU32T.js","getPastedJson-CwiYOonh.js","icon-DYDpWmDf.js","MethodPill-C-J-l7_c.js","DuplicateIcon-B6ARwg9w.js","createIcon-Dsv4MtDq.js","DynamicMarkdown-CtasenyM.js","SectionHeading-YNcgYwjB.js","axios-vUo_bRtp.js","Markdown-CwLx6PAg.js","clsx-C3kuh_dz.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-CmKHfscc.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-U3mI6Ljh.js"]}