Sandboxes

Create a new sandbox

Creates a sandbox and returns immediately with status: starting. The VM boots asynchronously. Poll GET /sandboxes/{id} until status is active before running commands.

post/sandboxes

Request body

namestring required

Human-readable name for the sandbox.

from_snapshotstring uuid

If provided, boot the sandbox from this snapshot instead of creating a fresh VM. The snapshot must belong to the same team.

Example request

{
  "network": {
    "allow_out": [
      "api.openai.com",
      "*.github.com",
      "8.8.8.8/32"
    ],
    "deny_out": [
      "0.0.0.0/0"
    ]
  }
}

Response

Sandbox created

idstring uuid

namestring

status'starting' | 'active' | 'pausing' | 'idle' | 'deleted'

vcpu_countinteger

memory_mibinteger

ip_addressstring

IP address of the running VM (present when status is active).

snapshot_idstring uuid

ID of the latest snapshot (present after a pause).

created_atstring date-time

Changes

Changed in 1 of the 2 revisions of this API.61

Apr 9, 2026304fe18155b861See the full diff
- ●
  removed the request property allow_internet_access
  request-property-removed
- ●
  removed the request property metadata
  request-property-removed
- ●
  removed the request property timeout_seconds
  request-property-removed
- ●
  removed the optional property metadata from the response with the 201 status
  response-optional-property-removed
- ●
  removed the optional property network from the response with the 201 status
  response-optional-property-removed
- ●
  removed the optional property timeout_seconds from the response with the 201 status
  response-optional-property-removed
- ○
  added the optional property ip_address to the response with the 201 status
  response-optional-property-added

Full history