v48

latestOpenAPI 3.1.0raw.githubusercontent.com2026-05-275867561.6 MB

sandboxes

Create a sandbox

Create a new sandbox from a snapshot. Provide at most one of snapshot_id or snapshot_name; if neither is provided, the server uses the default static blueprint.

post/v2/sandboxes/boxes

Request body

delete_after_stop_secondsinteger

fs_capacity_bytesinteger

idle_ttl_secondsinteger

mem_bytesinteger

namestring

restore_memoryboolean

RestoreMemory, when non-nil, overrides the server default for whether to resume the sandbox from its captured memory snapshot.

true → resume from the memory snapshot if it exists; cold-boot the sandbox otherwise. false → always cold-boot, even if a memory snapshot exists. nil → use the server default.

Applies to this request only; a later stop+start of the same sandbox reverts to the server default.

snapshot_idstring

snapshot_namestring

tag_value_idsstring[]

vcpusinteger

Response

Created

created_atstring

created_bystring

dataplane_urlstring

delete_after_stop_secondsinteger

fs_capacity_bytesinteger

idstring

idle_ttl_secondsinteger

mem_bytesinteger

namestring

size_classstring

snapshot_idstring

statusstring

status_messagestring

stopped_atstring

updated_atstring

updated_bystring

vcpusinteger