When the image has a warm pool, you get a sandbox that is already running: the answer has status: "running" and from_pool: true. Otherwise the answer has status: "creating". Poll GET /sandboxes/{sandbox} until it is running (usually a few seconds, a Windows sandbox woken cold can take longer) or failed (error says why).
The variables in env are in place before the sandbox shows as running.
To create a sandbox you need credit for at least an hour of it, the first 10 EUR top-up done, no overdue invoice, a free slot (limits.max in GET /sandboxes/images), an image within your account level’s size, and an image in stock (in_stock). When one of these is missing, the answer is 422 with the reason in message.
API token from your CloudBlast account settings. Pass as Authorization: Bearer <token>.
Body
application/json
image_id
integer
required
From GET /sandboxes/images. The image decides the OS, the size and the location.
Example:
3
name
string | null
Maximum string length: 60
Example:
"research-agent"
auto_stop_minutes
integer | null
Minutes without activity before the sandbox is stopped. 0 means never, otherwise from 5 to 43200 (30 days). Leave it out for the default (lifecycle.auto_stop_minutes, 15 unless the platform says otherwise).
Example:
30
auto_destroy_minutes
integer | null
Minutes the sandbox may stay stopped before it is destroyed. -1 means never. 0 means as soon as it stops (ephemeral). Leave it out for the default (lifecycle.auto_destroy_minutes, never unless the platform says otherwise).
Required range: -1 <= x <= 43200
Example:
1440
ephemeral
boolean
default:false
Destroy the sandbox as soon as it stops. The same as auto_destroy_minutes: 0, and it wins over auto_destroy_minutes.
env
object | null
Environment variables, as {"NAME": "value"}. Names use letters, digits and _, do not start with a digit, and are up to 128 characters. Up to 50 variables, 32 KB in all. Values are text. They are stored encrypted, and only the names are shown again.
Show child attributes
Example:
{ "API_TOKEN": "abc123", "MODE": "test" }
Response
Sandbox created. Running when it came from the warm pool, otherwise creating.
data
object
Show child attributes
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/schema.json","name":"CloudBlast Documentation","colors":{"primary":"#6366F1","light":"#818CF8","dark":"#4F46E5"},"logo":{"light":"https://mintcdn.com/cloudblastllc/UjwQ5b7jMNVfxnfM/logodark.svg?fit=max\u0026auto=format\u0026n=UjwQ5b7jMNVfxnfM\u0026q=85\u0026s=835178d0faa08ff213bc8c7adf4009c6","dark":"https://mintcdn.com/cloudblastllc/UjwQ5b7jMNVfxnfM/logowhite.svg?fit=max\u0026auto=format\u0026n=UjwQ5b7jMNVfxnfM\u0026q=85\u0026s=ba1dc60181ad3a8a902eb225d803292f"},"favicon":"https://mintcdn.com/cloudblastllc/UjwQ5b7jMNVfxnfM/cloudblast-logo.svg?fit=max\u0026auto=format\u0026n=UjwQ5b7jMNVfxnfM\u0026q=85\u0026s=5cdb4f5b7328cb787676436d8a3a0f9a","api":{"playground":{}},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"cloudblastllc","hasAudioNarration":false,"actualSubdomain":"cloudblastllc","customDomains":["docs.cloudblast.io"],"gitSource":{"type":"github","owner":"skeid9","repo":"cloudblast-panel","deployBranch":"prod","contentDirectory":"docs","isPrivate":true,"mountPath":"","label":""},"entitlements":{},"buildId":"6b0025d71e592fb6624e4a96","clientVersion":"0.0.4248","searchFilterCounts":[{"language":"default","tag":"API Reference","count":61},{"language":"default","tag":"Sandboxes","count":10},{"language":"default","tag":"Workers","count":10},{"language":"default","tag":"Security Groups","count":9},{"language":"default","tag":"Servers","count":9},{"language":"default","tag":"Getting Started","count":7},{"language":"default","tag":"Server IPs","count":5},{"language":"default","tag":"Backups","count":4},{"language":"default","tag":"Reserved IPs","count":4},{"language":"default","tag":"Account","count":3}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[],"googleFontsInlined":false},"customCss":[]}
{"page":{"pagePath":"api-reference/sandboxes/create-sandbox","slug":"/api-reference/sandboxes/create-sandbox","pageMetadata":{"title":"Create a Sandbox","openapi":"POST /sandboxes","description":"Creates a sandbox from an image and starts it.\n\nWhen the image has a warm pool, you get a sandbox that is already running: the answer has `status: \"running\"` and `from_pool: true`. Otherwise the answer has `status: \"creating\"`. Poll `GET /sandboxes/{sandbox}` until it is `running` (usually a few seconds, a Windows sandbox woken cold can take longer) or `failed` (`error` says why).\n\nThe variables in `env` are in place before the sandbox shows as `running`.\n\nTo create a sandbox you need credit for at least an hour of it, the first 10 EUR top-up done, no overdue invoice, a free slot (`limits.max` in `GET /sandboxes/images`), an image within your account level's size, and an image in stock (`in_stock`). When one of these is missing, the answer is 422 with the reason in `message`.\n\nRate limit: 30 a minute, see [Limits](/sandboxes#limits).","href":"/api-reference/sandboxes/create-sandbox"},"description":{"compiledSource":"\"use strict\";\nconst {Fragment: _Fragment, jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n a: \"a\",\n code: \"code\",\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_Fragment, {\n children: [_jsx(_components.p, {\n children: \"Creates a sandbox from an image and starts it.\"\n }), \"\\n\", _jsxs(_components.p, {\n children: [\"When the image has a warm pool, you get a sandbox that is already running: the answer has \", _jsx(_components.code, {\n children: \"status: \\\"running\\\"\"\n }), \" and \", _jsx(_components.code, {\n children: \"from_pool: true\"\n }), \". Otherwise the answer has \", _jsx(_components.code, {\n children: \"status: \\\"creating\\\"\"\n }), \". Poll \", _jsx(_components.code, {\n children: \"GET /sandboxes/{sandbox}\"\n }), \" until it is \", _jsx(_components.code, {\n children: \"running\"\n }), \" (usually a few seconds, a Windows sandbox woken cold can take longer) or \", _jsx(_components.code, {\n children: \"failed\"\n }), \" (\", _jsx(_components.code, {\n children: \"error\"\n }), \" says why).\"]\n }), \"\\n\", _jsxs(_components.p, {\n children: [\"The variables in \", _jsx(_components.code, {\n children: \"env\"\n }), \" are in place before the sandbox shows as \", _jsx(_components.code, {\n children: \"running\"\n }), \".\"]\n }), \"\\n\", _jsxs(_components.p, {\n children: [\"To create a sandbox you need credit for at least an hour of it, the first 10 EUR top-up done, no overdue invoice, a free slot (\", _jsx(_components.code, {\n children: \"limits.max\"\n }), \" in \", _jsx(_components.code, {\n children: \"GET /sandboxes/images\"\n }), \"), an image within your account level’s size, and an image in stock (\", _jsx(_components.code, {\n children: \"in_stock\"\n }), \"). When one of these is missing, the answer is 422 with the reason in \", _jsx(_components.code, {\n children: \"message\"\n }), \".\"]\n }), \"\\n\", _jsxs(_components.p, {\n children: [\"Rate limit: 30 a minute, see \", _jsx(_components.a, {\n href: \"/sandboxes#limits\",\n children: \"Limits\"\n }), \".\"]\n })]\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=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":"Create a Sandbox","openapi":"POST /sandboxes","description":"Creates a sandbox from an image and starts it.\n\nWhen the image has a warm pool, you get a sandbox that is already running: the answer has `status: \"running\"` and `from_pool: true`. Otherwise the answer has `status: \"creating\"`. Poll `GET /sandboxes/{sandbox}` until it is `running` (usually a few seconds, a Windows sandbox woken cold can take longer) or `failed` (`error` says why).\n\nThe variables in `env` are in place before the sandbox shows as `running`.\n\nTo create a sandbox you need credit for at least an hour of it, the first 10 EUR top-up done, no overdue invoice, a free slot (`limits.max` in `GET /sandboxes/images`), an image within your account level's size, and an image in stock (`in_stock`). When one of these is missing, the answer is 422 with the reason in `message`.\n\nRate limit: 30 a minute, see [Limits](/sandboxes#limits).","href":"/api-reference/sandboxes/create-sandbox"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"operationId":"createSandbox","tags":["Sandboxes"],"summary":"Create a sandbox","description":"Creates a sandbox from an image and starts it.\n\nWhen the image has a warm pool, you get a sandbox that is already running: the answer has `status: \"running\"` and `from_pool: true`. Otherwise the answer has `status: \"creating\"`. Poll `GET /sandboxes/{sandbox}` until it is `running` (usually a few seconds, a Windows sandbox woken cold can take longer) or `failed` (`error` says why).\n\nThe variables in `env` are in place before the sandbox shows as `running`.\n\nTo create a sandbox you need credit for at least an hour of it, the first 10 EUR top-up done, no overdue invoice, a free slot (`limits.max` in `GET /sandboxes/images`), an image within your account level's size, and an image in stock (`in_stock`). When one of these is missing, the answer is 422 with the reason in `message`.\n\nRate limit: 30 a minute, see [Limits](/sandboxes#limits).","requestBody":"d370c974-116d-4c0b-8671-f25281b722f5","responses":{"201":"d67447cc-9bed-45dd-a9e2-830897875264","401":"22510047-08da-4edb-8c1c-df31db0a4dea","422":"1c273c6d-88b2-44c2-98dd-271554f977be"},"method":"post","type":"path","servers":["9df3a9de-eb09-424b-97db-b79bcf6469e8"],"security":["1d58888c-ae97-49dc-a5b6-8430375f79fb"],"path":"/sandboxes","baseUrlOptions":["https://console.cloudblast.io/api/v2"],"title":"Create a sandbox","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["image_id"],"properties":{"image_id":{"type":"integer","description":"From `GET /sandboxes/images`. The image decides the OS, the size and the location.","example":3,"isRequired":true,"uniqueKey":"image_id","typeLabel":"integer"},"name":{"oneOf":[{"type":"string","maxLength":60,"example":"research-agent","uniqueKey":"name.oneOf.0","typeLabel":"string"},{"type":"null","maxLength":60,"example":"research-agent","uniqueKey":"name.oneOf.1","typeLabel":"null"}],"uniqueKey":"name","typeLabel":"string | null"},"auto_stop_minutes":{"oneOf":[{"type":"integer","description":"Minutes without activity before the sandbox is stopped. 0 means never, otherwise from 5 to 43200 (30 days). Leave it out for the default (`lifecycle.auto_stop_minutes`, 15 unless the platform says otherwise).","example":30,"uniqueKey":"auto_stop_minutes.oneOf.0","typeLabel":"integer"},{"type":"null","description":"Minutes without activity before the sandbox is stopped. 0 means never, otherwise from 5 to 43200 (30 days). Leave it out for the default (`lifecycle.auto_stop_minutes`, 15 unless the platform says otherwise).","example":30,"uniqueKey":"auto_stop_minutes.oneOf.1","typeLabel":"null"}],"uniqueKey":"auto_stop_minutes","typeLabel":"integer | null"},"auto_destroy_minutes":{"oneOf":[{"type":"integer","minimum":-1,"maximum":43200,"description":"Minutes the sandbox may stay stopped before it is destroyed. -1 means never. 0 means as soon as it stops (ephemeral). Leave it out for the default (`lifecycle.auto_destroy_minutes`, never unless the platform says otherwise).","example":1440,"uniqueKey":"auto_destroy_minutes.oneOf.0","typeLabel":"integer"},{"type":"null","minimum":-1,"maximum":43200,"description":"Minutes the sandbox may stay stopped before it is destroyed. -1 means never. 0 means as soon as it stops (ephemeral). Leave it out for the default (`lifecycle.auto_destroy_minutes`, never unless the platform says otherwise).","example":1440,"uniqueKey":"auto_destroy_minutes.oneOf.1","typeLabel":"null"}],"uniqueKey":"auto_destroy_minutes","typeLabel":"integer | null"},"ephemeral":{"type":"boolean","default":false,"description":"Destroy the sandbox as soon as it stops. The same as `auto_destroy_minutes: 0`, and it wins over `auto_destroy_minutes`.","uniqueKey":"ephemeral","typeLabel":"boolean"},"env":{"oneOf":[{"type":"object","description":"Environment variables, as `{\"NAME\": \"value\"}`. Names use letters, digits and `_`, do not start with a digit, and are up to 128 characters. Up to 50 variables, 32 KB in all. Values are text. They are stored encrypted, and only the names are shown again.","additionalProperties":{"type":"string","uniqueKey":"env.oneOf.0.additionalProperties","typeLabel":"string"},"example":{"API_TOKEN":"abc123","MODE":"test"},"uniqueKey":"env.oneOf.0","typeLabel":"object"},{"type":"null","description":"Environment variables, as `{\"NAME\": \"value\"}`. Names use letters, digits and `_`, do not start with a digit, and are up to 128 characters. Up to 50 variables, 32 KB in all. Values are text. They are stored encrypted, and only the names are shown again.","additionalProperties":{"type":"string","uniqueKey":"env.oneOf.1.additionalProperties","typeLabel":"string"},"example":{"API_TOKEN":"abc123","MODE":"test"},"uniqueKey":"env.oneOf.1","typeLabel":"null"}],"uniqueKey":"env","typeLabel":"object | null"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"image_id":3,"name":"research-agent","auto_stop_minutes":30,"auto_destroy_minutes":1440,"ephemeral":false,"env":{"API_TOKEN":"abc123","MODE":"test"}}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"d67447cc-9bed-45dd-a9e2-830897875264":{"description":"Sandbox created. Running when it came from the warm pool, otherwise creating.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"uuid":{"type":"string","format":"uuid","description":"Sandbox handle. Use this as the `{sandbox}` path parameter.","example":"9b2f4c1e-7d3a-4e8b-a5c6-1f0e2d3c4b5a","uniqueKey":"data.uuid","typeLabel":"string\u003cuuid>"},"name":{"oneOf":[{"type":"string","example":"research-agent","uniqueKey":"data.name.oneOf.0","typeLabel":"string"},{"type":"null","example":"research-agent","uniqueKey":"data.name.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.name","typeLabel":"string | null"},"image":{"oneOf":[{"type":"string","description":"Name of the image it was created from.","example":"Ubuntu 24.04 Desktop","uniqueKey":"data.image.oneOf.0","typeLabel":"string"},{"type":"null","description":"Name of the image it was created from.","example":"Ubuntu 24.04 Desktop","uniqueKey":"data.image.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.image","typeLabel":"string | null"},"desktop":{"type":"boolean","description":"True when it was created from a desktop image, so computer use works.","example":true,"uniqueKey":"data.desktop","typeLabel":"boolean"},"status":{"type":"string","description":"`creating`: being created. `running`: ready to use. `stopping`, `stopped`, `starting`: on its way down, down with its disk kept, on its way up again. `deleting`: being destroyed. `failed`: it could not be created, see `error`. `deleted` only shows in the answer to an action on a sandbox that is already gone.","enum":["creating","running","stopping","stopped","starting","deleting","deleted","failed"],"example":"running","uniqueKey":"data.status","typeLabel":"enum\u003cstring>"},"os":{"type":"string","enum":["linux","windows"],"example":"linux","uniqueKey":"data.os","typeLabel":"enum\u003cstring>"},"vcpu":{"type":"integer","example":2,"uniqueKey":"data.vcpu","typeLabel":"integer"},"memory_mb":{"type":"integer","example":4096,"uniqueKey":"data.memory_mb","typeLabel":"integer"},"disk_gb":{"type":"integer","example":20,"uniqueKey":"data.disk_gb","typeLabel":"integer"},"private_ip":{"oneOf":[{"type":"string","description":"Its address on the private sandbox network, once it has one.","example":"10.80.0.14","uniqueKey":"data.private_ip.oneOf.0","typeLabel":"string"},{"type":"null","description":"Its address on the private sandbox network, once it has one.","example":"10.80.0.14","uniqueKey":"data.private_ip.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.private_ip","typeLabel":"string | null"},"location":{"oneOf":[{"type":"object","description":"The region a sandbox or an image runs in. `null` when it is not known.","properties":{"id":{"type":"integer","example":1,"uniqueKey":"data.location.oneOf.0.id","typeLabel":"integer"},"name":{"type":"string","example":"Frankfurt, Germany","uniqueKey":"data.location.oneOf.0.name","typeLabel":"string"},"short_code":{"type":"string","example":"fra","uniqueKey":"data.location.oneOf.0.short_code","typeLabel":"string"},"icon":{"oneOf":[{"type":"string","description":"URL of the location's icon.","example":"https://console.cloudblast.io/storage/locations/de.svg","uniqueKey":"data.location.oneOf.0.icon.oneOf.0","typeLabel":"string"},{"type":"null","description":"URL of the location's icon.","example":"https://console.cloudblast.io/storage/locations/de.svg","uniqueKey":"data.location.oneOf.0.icon.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.location.oneOf.0.icon","typeLabel":"string | null"}},"uniqueKey":"data.location.oneOf.0","typeLabel":"object"},{"type":"null","description":"The region a sandbox or an image runs in. `null` when it is not known.","properties":{"id":{"type":"integer","example":1},"name":{"type":"string","example":"Frankfurt, Germany"},"short_code":{"type":"string","example":"fra"},"icon":{"oneOf":[{"type":"string","description":"URL of the location's icon.","example":"https://console.cloudblast.io/storage/locations/de.svg"},{"type":"null","description":"URL of the location's icon.","example":"https://console.cloudblast.io/storage/locations/de.svg"}]}},"uniqueKey":"data.location.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.location","typeLabel":"object | null"},"error":{"oneOf":[{"type":"string","description":"Why the last create, start or stop did not work. `null` when all is well.","example":null,"uniqueKey":"data.error.oneOf.0","typeLabel":"string"},{"type":"null","description":"Why the last create, start or stop did not work. `null` when all is well.","example":null,"uniqueKey":"data.error.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.error","typeLabel":"string | null"},"hourly_price":{"type":"number","description":"Price per hour while it runs.","example":0.03,"uniqueKey":"data.hourly_price","typeLabel":"number"},"stopped_hourly_price":{"type":"number","description":"Price per hour while it is stopped: its disk only.","example":0.002,"uniqueKey":"data.stopped_hourly_price","typeLabel":"number"},"current_hourly_price":{"type":"number","description":"Price per hour as it is now.","example":0.03,"uniqueKey":"data.current_hourly_price","typeLabel":"number"},"billed_total":{"type":"number","description":"Charged so far, billed per minute.","example":0.01225,"uniqueKey":"data.billed_total","typeLabel":"number"},"billed_until":{"oneOf":[{"type":"string","format":"date-time","description":"Up to when it has been billed.","example":"2026-11-19T10:15:42+00:00","uniqueKey":"data.billed_until.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","description":"Up to when it has been billed.","example":"2026-11-19T10:15:42+00:00","uniqueKey":"data.billed_until.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.billed_until","typeLabel":"string\u003cdate-time> | null"},"from_pool":{"type":"boolean","description":"True when it was handed over already running from the warm pool.","example":true,"uniqueKey":"data.from_pool","typeLabel":"boolean"},"env":{"type":"array","items":{"type":"string","uniqueKey":"data.env.items.[INDEX]","typeLabel":"string"},"description":"The names of its environment variables. The values are never shown again.","example":["API_TOKEN","MODE"],"uniqueKey":"data.env","typeLabel":"string[]"},"auto_stop_minutes":{"type":"integer","description":"Minutes without activity before it is stopped. 0 means never.","example":15,"uniqueKey":"data.auto_stop_minutes","typeLabel":"integer"},"auto_destroy_minutes":{"type":"integer","description":"Minutes it may stay stopped before it is destroyed. -1 means never, 0 means as soon as it stops.","example":-1,"uniqueKey":"data.auto_destroy_minutes","typeLabel":"integer"},"ephemeral":{"type":"boolean","description":"True when it is destroyed as soon as it stops.","example":false,"uniqueKey":"data.ephemeral","typeLabel":"boolean"},"created_at":{"type":"string","format":"date-time","example":"2026-11-19T09:58:02+00:00","uniqueKey":"data.created_at","typeLabel":"string\u003cdate-time>"},"stops_at":{"oneOf":[{"type":"string","format":"date-time","description":"When a running sandbox stops if nothing uses it before then. `null` when it is not running, or never stops by itself.","example":"2026-11-19T10:30:42+00:00","uniqueKey":"data.stops_at.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","description":"When a running sandbox stops if nothing uses it before then. `null` when it is not running, or never stops by itself.","example":"2026-11-19T10:30:42+00:00","uniqueKey":"data.stops_at.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.stops_at","typeLabel":"string\u003cdate-time> | null"},"destroys_at":{"oneOf":[{"type":"string","format":"date-time","description":"When a stopped sandbox is destroyed. `null` when it is not stopped, or is never destroyed by itself.","example":null,"uniqueKey":"data.destroys_at.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","description":"When a stopped sandbox is destroyed. `null` when it is not stopped, or is never destroyed by itself.","example":null,"uniqueKey":"data.destroys_at.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.destroys_at","typeLabel":"string\u003cdate-time> | null"}},"uniqueKey":"data","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"data":{"uuid":"9b2f4c1e-7d3a-4e8b-a5c6-1f0e2d3c4b5a","name":"research-agent","image":"Ubuntu 24.04 Desktop","desktop":true,"status":"running","os":"linux","vcpu":2,"memory_mb":4096,"disk_gb":20,"private_ip":"10.80.0.14","location":{"id":1,"name":"Frankfurt, Germany","short_code":"fra","icon":"https://console.cloudblast.io/storage/locations/de.svg"},"error":null,"hourly_price":0.03,"stopped_hourly_price":0.002,"current_hourly_price":0.03,"billed_total":0.01225,"billed_until":"2026-11-19T10:15:42+00:00","from_pool":true,"env":["API_TOKEN","MODE"],"auto_stop_minutes":15,"auto_destroy_minutes":-1,"ephemeral":false,"created_at":"2026-11-19T09:58:02+00:00","stops_at":"2026-11-19T10:30:42+00:00","destroys_at":null}}}},"exampleType":"generated"}},"exampleType":"generated"},"22510047-08da-4edb-8c1c-df31db0a4dea":{"description":"Authentication failed","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","description":"Machine-readable error code","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","description":"Human-readable error message","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"}},"required":["code","message"],"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"example":{"error":{"code":"UNAUTHENTICATED","message":"Missing or invalid Authorization header. Use: Authorization: Bearer \u003ctoken>"}},"examples":{"Example":{"title":"Example","value":{"error":{"code":"UNAUTHENTICATED","message":"Missing or invalid Authorization header. Use: Authorization: Bearer \u003ctoken>"}}}},"exampleType":"examples"}},"exampleType":"examples"},"1c273c6d-88b2-44c2-98dd-271554f977be":{"description":"A rule was broken (credit, slots, image), or a field failed validation","content":{"application/json":{"schema":{"type":"object","description":"How the sandbox endpoints answer an error: a `message`, not an error code. `errors` is only there when a request field failed validation.","properties":{"message":{"type":"string","description":"What went wrong, in plain words.","example":"Start the sandbox first.","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"errors":{"type":"object","description":"Messages per field, only when a field failed validation.","additionalProperties":{"type":"array","items":{"type":"string","uniqueKey":"errors.additionalProperties.items.[INDEX]","typeLabel":"string"},"uniqueKey":"errors.additionalProperties","typeLabel":"string[]"},"example":{"image_id":["The image id field is required."]},"uniqueKey":"errors","typeLabel":"object"}},"required":["message"],"uniqueKey":"","typeLabel":"object"},"examples":{"no_credit":{"title":"no_credit","summary":"Not enough credit","value":{"message":"Not enough credit: at least 0.10€ is needed, an hour of this sandbox. Please top up first."}},"no_slot":{"title":"no_slot","summary":"No free slot","value":{"message":"Your account level allows 2 sandboxes at the same time. Destroy one, or raise your level, to start another."}},"image":{"title":"image","summary":"Image not available","value":{"message":"This image is not available right now."}},"env":{"title":"env","summary":"Bad environment variable","value":{"message":"\"1TOKEN\" is not a valid variable name: letters, digits and _, not starting with a digit."}},"validation":{"title":"validation","summary":"A field failed validation","value":{"message":"The image id field is required.","errors":{"image_id":["The image id field is required."]}}}},"exampleType":"examples"}},"exampleType":"examples"}},"security":{"1d58888c-ae97-49dc-a5b6-8430375f79fb":{"bearerAuth":{"type":"http","scheme":"bearer","description":"API token from your CloudBlast account settings. Pass as `Authorization: Bearer \u003ctoken>`.","scopes":[],"schemeName":"bearerAuth"}}},"servers":{"9df3a9de-eb09-424b-97db-b79bcf6469e8":{"url":"https://console.cloudblast.io/api/v2","description":"Production"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","description":"API token from your CloudBlast account settings. Pass as `Authorization: Bearer \u003ctoken>`.","scopes":[],"schemeName":"bearerAuth"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"API token from your CloudBlast account settings. Pass as `Authorization: Bearer \u003ctoken>`.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"bearerAuth","name":"Authorization"}],"title":"bearerAuth"}]},"originalFileLocation":"openapi.json"},"subdomain":"cloudblastllc","siteName":"CloudBlast Documentation","title":"Create a Sandbox - CloudBlast Documentation","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-20T10:50:04.887Z","originalFileLocation":"api-reference/sandboxes/create-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=\"Creates a sandbox from an image and starts it. When the image has a warm pool, you get a sandbox that is already running: the answer has status: \u0026quot;running\u0026quot; and from_pool: true. Otherwise the answer has status: \u0026quot;creating\u0026quot;. Poll GET /sandboxes/{sandbox} until it is running (usually a few seconds, a Windows sandbox woken cold can take longer) or failed (error says why). The variables in env are in place before the sandbox shows as running. To create a sandbox you need credit for at least an hour of it, the first 10 EUR top-up done, no overdue invoice, a free slot (limits.max in GET /sandboxes/images), an image within your account level\u0026#x27;s size, and an image in stock (in_stock). When one of these is missing, the answer is 422 with the reason in message. Rate limit: 30 a minute, see Limits.\">\u003cmeta data-mint-head name=\"application-name\" content=\"CloudBlast 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/cloudblastllc/lR1uxlLZXRv8BFdr/_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/cloudblastllc/lR1uxlLZXRv8BFdr/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/cloudblastllc/lR1uxlLZXRv8BFdr/_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/cloudblastllc/lR1uxlLZXRv8BFdr/_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/cloudblastllc/lR1uxlLZXRv8BFdr/_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/cloudblastllc/lR1uxlLZXRv8BFdr/_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/cloudblastllc/lR1uxlLZXRv8BFdr/_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/cloudblastllc/lR1uxlLZXRv8BFdr/_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/cloudblastllc/lR1uxlLZXRv8BFdr/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Create a Sandbox - CloudBlast Documentation\">\u003cmeta data-mint-head property=\"og:description\" content=\"Creates a sandbox from an image and starts it. When the image has a warm pool, you get a sandbox that is already running: the answer has status: \u0026quot;running\u0026quot; and from_pool: true. Otherwise the answer has status: \u0026quot;creating\u0026quot;. Poll GET /sandboxes/{sandbox} until it is running (usually a few seconds, a Windows sandbox woken cold can take longer) or failed (error says why). The variables in env are in place before the sandbox shows as running. To create a sandbox you need credit for at least an hour of it, the first 10 EUR top-up done, no overdue invoice, a free slot (limits.max in GET /sandboxes/images), an image within your account level\u0026#x27;s size, and an image in stock (in_stock). When one of these is missing, the answer is 422 with the reason in message. Rate limit: 30 a minute, see Limits.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"CloudBlast Documentation\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.cloudblast.io/api-reference/sandboxes/create-sandbox\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://cloudblastllc.mintlify.site/_mintlify/api/og/v2?division=Sandboxes\u0026amp;title=Create+a+Sandbox\u0026amp;description=Creates+a+sandbox+from+an+image+and+starts+it.%0A%0AWhen+the+image+has+a+warm+pool%2C+you+get+a+sandbox+that+is+already+running%3A+the+answer+has+%60status%3A+%22running%22%60+an\u0026amp;theme=c26d60bea0ae7dd10612fde1\u0026amp;signature=ced289b1f11d01d916e55a8565fcd893f0ce80c0af6e01f39da667f62de1ce61\">\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 a Sandbox - CloudBlast Documentation\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Creates a sandbox from an image and starts it. When the image has a warm pool, you get a sandbox that is already running: the answer has status: \u0026quot;running\u0026quot; and from_pool: true. Otherwise the answer has status: \u0026quot;creating\u0026quot;. Poll GET /sandboxes/{sandbox} until it is running (usually a few seconds, a Windows sandbox woken cold can take longer) or failed (error says why). The variables in env are in place before the sandbox shows as running. To create a sandbox you need credit for at least an hour of it, the first 10 EUR top-up done, no overdue invoice, a free slot (limits.max in GET /sandboxes/images), an image within your account level\u0026#x27;s size, and an image in stock (in_stock). When one of these is missing, the answer is 422 with the reason in message. Rate limit: 30 a minute, see Limits.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://cloudblastllc.mintlify.site/_mintlify/api/og/v2?division=Sandboxes\u0026amp;title=Create+a+Sandbox\u0026amp;description=Creates+a+sandbox+from+an+image+and+starts+it.%0A%0AWhen+the+image+has+a+warm+pool%2C+you+get+a+sandbox+that+is+already+running%3A+the+answer+has+%60status%3A+%22running%22%60+an\u0026amp;theme=c26d60bea0ae7dd10612fde1\u0026amp;signature=ced289b1f11d01d916e55a8565fcd893f0ce80c0af6e01f39da667f62de1ce61\">\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/cloudblastllc/lR1uxlLZXRv8BFdr/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"CloudBlast Documentation\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#6366F1\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.cloudblast.io/api-reference/sandboxes/create-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/create-sandbox.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.cloudblast.io/#organization\",\"name\":\"CloudBlast Documentation\",\"url\":\"https://docs.cloudblast.io\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/cloudblastllc/UjwQ5b7jMNVfxnfM/logodark.svg?fit=max\u0026auto=format\u0026n=UjwQ5b7jMNVfxnfM\u0026q=85\u0026s=835178d0faa08ff213bc8c7adf4009c6\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.cloudblast.io#website\",\"name\":\"CloudBlast Documentation\",\"url\":\"https://docs.cloudblast.io\",\"publisher\":{\"@id\":\"https://docs.cloudblast.io/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.cloudblast.io/api-reference/sandboxes/create-sandbox#webpage\",\"url\":\"https://docs.cloudblast.io/api-reference/sandboxes/create-sandbox\",\"name\":\"Create a Sandbox\",\"description\":\"Creates a sandbox from an image and starts it. When the image has a warm pool, you get a sandbox that is already running: the answer has status: \\\"running\\\" and from_pool: true. Otherwise the answer has status: \\\"creating\\\". Poll GET /sandboxes/{sandbox} until it is running (usually a few seconds, a Windows sandbox woken cold can take longer) or failed (error says why). The variables in env are in place before the sandbox shows as running. To create a sandbox you need credit for at least an hour of it, the first 10 EUR top-up done, no overdue invoice, a free slot (limits.max in GET /sandboxes/images), an image within your account level's size, and an image in stock (in_stock). When one of these is missing, the answer is 422 with the reason in message. Rate limit: 30 a minute, see Limits.\",\"dateModified\":\"2026-11-20T10:50:04.887Z\",\"isPartOf\":{\"@id\":\"https://docs.cloudblast.io#website\"},\"breadcrumb\":{\"@id\":\"https://docs.cloudblast.io/api-reference/sandboxes/create-sandbox#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.cloudblast.io/api-reference/sandboxes/create-sandbox#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Sandboxes\",\"item\":\"https://docs.cloudblast.io/api-reference/sandboxes/list-images\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Create a Sandbox\",\"item\":\"https://docs.cloudblast.io/api-reference/sandboxes/create-sandbox\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.cloudblast.io/api-reference/sandboxes/create-sandbox#apireference\",\"headline\":\"Create a Sandbox\",\"name\":\"Create a Sandbox\",\"description\":\"Creates a sandbox from an image and starts it. When the image has a warm pool, you get a sandbox that is already running: the answer has status: \\\"running\\\" and from_pool: true. Otherwise the answer has status: \\\"creating\\\". Poll GET /sandboxes/{sandbox} until it is running (usually a few seconds, a Windows sandbox woken cold can take longer) or failed (error says why). The variables in env are in place before the sandbox shows as running. To create a sandbox you need credit for at least an hour of it, the first 10 EUR top-up done, no overdue invoice, a free slot (limits.max in GET /sandboxes/images), an image within your account level's size, and an image in stock (in_stock). When one of these is missing, the answer is 422 with the reason in message. Rate limit: 30 a minute, see Limits.\",\"url\":\"https://docs.cloudblast.io/api-reference/sandboxes/create-sandbox\",\"mainEntityOfPage\":{\"@id\":\"https://docs.cloudblast.io/api-reference/sandboxes/create-sandbox#webpage\"},\"dateModified\":\"2026-11-20T10:50:04.887Z\",\"publisher\":{\"@id\":\"https://docs.cloudblast.io/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.cloudblast.io#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"CloudBlast Documentation\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"CloudBlast Documentation\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/api-reference/sandboxes/create-sandbox.md","siteName":"CloudBlast Documentation","nav":{"global":null,"tabs":[{"tab":"Getting Started","pages":[{"title":"Getting Started","href":"/introduction"}]},{"tab":"API Reference","groups":[{"group":"Overview","pages":[{"title":"API Reference","href":"/api-reference/overview"}]},{"group":"Account","pages":[{"title":"Get Account Info","openapi":"GET /account","href":"/api-reference/account/get-account-info"},{"title":"Get Resource Usage","openapi":"GET /account/usage","href":"/api-reference/account/get-resource-usage"},{"title":"List Invoices","openapi":"GET /account/invoices","href":"/api-reference/account/list-invoices"}]},{"group":"Plans \u0026 Locations","pages":[{"title":"List Plans","openapi":"GET /plans","href":"/api-reference/plans/list-plans"},{"title":"List Locations","openapi":"GET /locations","href":"/api-reference/locations/list-locations"},{"title":"List Templates","openapi":"GET /locations/{location_id}/templates","href":"/api-reference/locations/list-templates"}]},{"group":"Servers","pages":[{"title":"List Servers","openapi":"GET /servers","href":"/api-reference/servers/list-servers"},{"title":"Create Server","openapi":"POST /servers","href":"/api-reference/servers/create-server"},{"title":"Get Server Details","openapi":"GET /servers/{server}","href":"/api-reference/servers/get-server"},{"title":"Get Server Credentials","openapi":"GET /servers/{server}/credentials","href":"/api-reference/servers/get-credentials"},{"title":"Delete Server","openapi":"DELETE /servers/{server}","href":"/api-reference/servers/delete-server"},{"title":"Send Power Action","openapi":"POST /servers/{server}/actions","href":"/api-reference/servers/power-action"},{"title":"Get Real-Time Status","openapi":"GET /servers/{server}/status","href":"/api-reference/servers/get-status"},{"title":"Reinstall OS","openapi":"POST /servers/{server}/reinstall","href":"/api-reference/servers/reinstall"},{"title":"Rename Server","openapi":"PATCH /servers/{server}/rename","href":"/api-reference/servers/rename"}]},{"group":"Server IPs","pages":[{"title":"List Server IPs","openapi":"GET /servers/{server}/ips","href":"/api-reference/server-ips/list-ips"},{"title":"Add Extra IPs","openapi":"POST /servers/{server}/ips","href":"/api-reference/server-ips/add-ips"},{"title":"Remove an IP","openapi":"DELETE /servers/{server}/ips/{address}","href":"/api-reference/server-ips/remove-ip"},{"title":"Move an IP to Reserved IPs","openapi":"POST /servers/{server}/ips/{address}/move-to-reserved","href":"/api-reference/server-ips/move-to-reserved"},{"title":"Set Reverse DNS","openapi":"PUT /servers/{server}/ips/{address}/rdns","href":"/api-reference/server-ips/set-rdns"}]},{"group":"Reserved IPs","pages":[{"title":"List Reserved IPs","openapi":"GET /reserved-ips","href":"/api-reference/reserved-ips/list-reserved-ips"},{"title":"List Reservable Subnets","openapi":"GET /reserved-ips/subnets","href":"/api-reference/reserved-ips/list-subnets"},{"title":"Reserve IPs","openapi":"POST /reserved-ips","href":"/api-reference/reserved-ips/reserve-ips"},{"title":"Release a Reserved IP","openapi":"DELETE /reserved-ips/{address}","href":"/api-reference/reserved-ips/release-ip"}]},{"group":"Backups","pages":[{"title":"List Backups","openapi":"GET /servers/{server}/backups","href":"/api-reference/backups/list-backups"},{"title":"Create Backup","openapi":"POST /servers/{server}/backups","href":"/api-reference/backups/create-backup"},{"title":"Restore Backup","openapi":"POST /servers/{server}/backups/{backup_uuid}/restore","href":"/api-reference/backups/restore-backup"},{"title":"Delete Backup","openapi":"DELETE /servers/{server}/backups/{backup_uuid}","href":"/api-reference/backups/delete-backup"}]},{"group":"SSH Keys","pages":[{"title":"List SSH Keys","openapi":"GET /ssh-keys","href":"/api-reference/ssh-keys/list-ssh-keys"},{"title":"Add SSH Key","openapi":"POST /ssh-keys","href":"/api-reference/ssh-keys/add-ssh-key"},{"title":"Delete SSH Key","openapi":"DELETE /ssh-keys/{id}","href":"/api-reference/ssh-keys/delete-ssh-key"}]},{"group":"Security Groups","pages":[{"title":"List Security Groups","openapi":"GET /security-groups","href":"/api-reference/security-groups/list-groups"},{"title":"Create Security Group","openapi":"POST /security-groups","href":"/api-reference/security-groups/create-group"},{"title":"Get Security Group","openapi":"GET /security-groups/{id}","href":"/api-reference/security-groups/get-group"},{"title":"Delete Security Group","openapi":"DELETE /security-groups/{id}","href":"/api-reference/security-groups/delete-group"},{"title":"Add Firewall Rule","openapi":"POST /security-groups/{id}/rules","href":"/api-reference/security-groups/add-rule"},{"title":"Delete Firewall Rule","openapi":"DELETE /security-groups/{id}/rules/{rule_id}","href":"/api-reference/security-groups/delete-rule"},{"title":"Apply Firewall Rules","openapi":"POST /security-groups/{id}/deploy","href":"/api-reference/security-groups/deploy"},{"title":"Attach Server","openapi":"POST /security-groups/{id}/servers/attach","href":"/api-reference/security-groups/attach-server"},{"title":"Detach Server","openapi":"DELETE /security-groups/{id}/servers/detach","href":"/api-reference/security-groups/detach-server"}]},{"group":"Workers","pages":[{"title":"List Workers","openapi":"GET /workers","href":"/api-reference/workers/list-workers"},{"title":"Deploy a Worker","openapi":"POST /workers","href":"/api-reference/workers/create-worker"},{"title":"Get Worker","openapi":"GET /workers/{worker}","href":"/api-reference/workers/get-worker"},{"title":"Update Worker","openapi":"PATCH /workers/{worker}","href":"/api-reference/workers/update-worker"},{"title":"Delete Worker","openapi":"DELETE /workers/{worker}","href":"/api-reference/workers/delete-worker"},{"title":"Deploy, Start, Stop, Restart","openapi":"POST /workers/{worker}/actions","href":"/api-reference/workers/worker-action"},{"title":"Get Worker Status","openapi":"GET /workers/{worker}/status","href":"/api-reference/workers/get-status"},{"title":"List Worker Locations","openapi":"GET /workers/locations","href":"/api-reference/workers/list-locations"},{"title":"List One-Click Templates","openapi":"GET /workers/templates","href":"/api-reference/workers/list-templates"},{"title":"Check Deploy Requirements","openapi":"GET /workers/deploy-requirements","href":"/api-reference/workers/deploy-requirements"}]},{"group":"Sandboxes","pages":[{"title":"List Sandbox Images","openapi":"GET /sandboxes/images","href":"/api-reference/sandboxes/list-images"},{"title":"List Sandboxes","openapi":"GET /sandboxes","description":"Your sandboxes, newest first: every one that exists, plus failed ones. Destroyed sandboxes are not listed. Not paginated.\n\n`meta.used` is how many slots your sandboxes take, and `meta.max` how many your account level allows. `meta.ever_used` is true once the account has created a sandbox.\n\nWhile sandboxes are switched off on the platform, `data` is empty.","href":"/api-reference/sandboxes/list-sandboxes"},{"title":"Create a Sandbox","openapi":"POST /sandboxes","href":"/api-reference/sandboxes/create-sandbox"},{"title":"Get Sandbox","openapi":"GET /sandboxes/{sandbox}","description":"One sandbox, with its login. `username` is `root` on Linux and `Administrator` on Windows. `password` is `null` until the sandbox's screen has been opened in the panel once.\n\nPoll this after creating or starting a sandbox until `status` is `running`. A destroyed sandbox answers 404.","href":"/api-reference/sandboxes/get-sandbox"},{"title":"Start Sandbox","openapi":"POST /sandboxes/{sandbox}/start","href":"/api-reference/sandboxes/start-sandbox"},{"title":"Stop Sandbox","openapi":"POST /sandboxes/{sandbox}/stop","href":"/api-reference/sandboxes/stop-sandbox"},{"title":"Destroy Sandbox","openapi":"DELETE /sandboxes/{sandbox}","href":"/api-reference/sandboxes/destroy-sandbox"},{"title":"Run a Command","openapi":"POST /sandboxes/{sandbox}/exec","href":"/api-reference/sandboxes/run-command"},{"title":"Computer Use","openapi":"POST /sandboxes/{sandbox}/computer","href":"/api-reference/sandboxes/computer-use"},{"title":"Get Sandbox Logs","openapi":"GET /sandboxes/{sandbox}/logs","href":"/api-reference/sandboxes/get-logs"}]}]},{"tab":"MCP","pages":[{"title":"MCP","href":"/mcp/overview"}]},{"tab":"CLI","pages":[{"title":"CLI","href":"/cli/overview"}]}]},"basePath":"","title":"Create a Sandbox - CloudBlast Documentation","deploymentId":"dpl_2pTxFtyBudBMYZiCw1MyvoA1wxpd","buildId":"dpl_2pTxFtyBudBMYZiCw1MyvoA1wxpd","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-BtG4DSkw.js","snippetPresets-C1k1xDhp.js","utils-PMJoEt4Y.js","style-to-object-BY3JEAdk.js","utils-DW3Pr7Jq.js","v4-DIgz8zy6.js","addUniqueKeysToSchema-DIISLO2w.js","conditional-requirements-CFM0id0Q.js","cloneDeep-BErNCZCm.js","_Uint8Array-f0PCu9f_.js","isObject-FP1Yky1u.js","ApiExamples-OjY-8mqu.js","usePlaygroundInputsStore-B2HS2hUb.js","shallow-DVFuuIDQ.js","isEqual-DG0UKiQC.js","CodeSnippets-Cy6FBgwN.js","CodeSnippet-D1PtG8ed.js","getApiPlaygroundDisplay-Dkx2eNtL.js","Page-C8Cg25if.js","DynamicMarkdown-BvJIe00T.js","SectionHeading-B0rKYV8d.js","icon-yclzBff4.js","MethodPill-DxA11cCF.js","getPastedJson-CpkIDpMk.js","DuplicateIcon-CFCQNJ-D.js","axios-CsQoIw0U.js","Markdown-CK5C-fmV.js","AssistantPageLink-Cw134Dd-.js","dist-3xM3Qrc7.js","lib-DMeTj1gb.js","lib-B8HbPgcC.js","katex-Dbtb6Wk7.js","html-void-elements-mCSPHezU.js","marked.esm-CZWythHk.js"]}