v51

latestOpenAPI 3.0.0raw.githubusercontent.com2026-08-035895111.8 KB

sandboxes

Create sandbox

Create a sandbox from the template

post/sandboxes

Request body

templateIDstring required

Identifier of the required template

timeoutinteger

Time to live for the sandbox in seconds.

autoPauseboolean

Automatically pauses the sandbox after the timeout

autoPauseMemoryboolean

Controls the snapshot kind taken when the sandbox auto-pauses on timeout (only relevant when autoPause is true). When false, the auto-pause drops the in-memory state and persists only the filesystem (a filesystem-only snapshot); resuming it cold-boots (reboots) the sandbox from disk. Such a snapshot cannot be auto-resumed by traffic and must be resumed explicitly, so it cannot be combined with autoResume. Defaults to true (full memory snapshot).

secureboolean

Secure all system communication with sandbox

allow_internet_accessboolean

Allow sandbox to access the internet. When set to false, it behaves the same as specifying denyOut to 0.0.0.0/0 in the network config.

{"stackTrail":"components:schemas:SandboxMetadata","oasType":"schema","type":"unknown"}

{"stackTrail":"components:schemas:EnvVars","oasType":"schema","type":"unknown"}

mcpMcp nullable

MCP configuration for the sandbox

Response

The sandbox was created successfully

templateIDstring required

Identifier of the template from which is the sandbox created

sandboxIDstring required

Identifier of the sandbox

aliasstring

Alias of the template

clientIDstring required

Identifier of the client

envdVersionstring required

Version of the envd running in the sandbox

envdAccessTokenstring

Access token used for envd communication

trafficAccessTokenstring nullable

Token required for accessing sandbox via proxy.

domainstring nullable

Base domain where the sandbox traffic is accessible