Create new sandbox
Authorizations
Body
- Image launch
- Snapshot restore
Provide exactly one start source: imageName (with optional imageId) or snapshotName (with optional snapshotId). vcpus, memMiB, and diskSizeMiB are only supported for image launches; snapshot launches always restore the snapshot's resources.
Image name to launch from (base image such as node, python, default, or a custom image).
Pin a specific image revision. Requires imageName.
Memory snapshot name to restore from.
Pin a specific snapshot revision. Requires snapshotName.
us, us-central, us-west, us-east, asia-south, europe-west Ports to expose at launch.
Volume mounts, keyed by absolute mount path inside the sandbox.
vCPU count (image launches only).
1 <= x <= 32Memory in MiB (image launches only).
512 <= x <= 262144Disk size in MiB (image launches only).
2048 <= x <= 32768Maximum sandbox lifetime in minutes, measured from VM start.
x <= 1440Outbound internet access policy.
Outbound allow rules (IPv4 address, CIDR range, or domain).
Outbound deny rules (IPv4 address or CIDR range).
Response
Sandbox created
Current sandbox lifecycle status.
active, closed, close-error, error us, us-central, us-west, us-east, asia-south, europe-west Connection details for the sandbox runtime API (process execution, files, terminals).
Start timestamp in epoch milliseconds.
End timestamp in epoch milliseconds.
Effective outbound network policy for a sandbox.
Dashboard URL for this sandbox.
Total runtime in milliseconds (0 while running).
Sandbox runtime session token (24h TTL). Null when the sandbox is unavailable.