API Reference
Sandboxes
Make and manage sandboxes outside a run.
Create a sandbox
POST/v1/sandboxes
{ "repo": "acme/web-app", "timeout_ms": 600000, "from": "web-app-seeded" }{ "id": "sbx_41c9", "state": "running", "expires_at": "2026-11-01T09:22:44Z" }Run a command
POST/v1/sandboxes/{id}/commands
{ "cmd": "npm test -- checkout", "timeout_ms": 120000 }{ "exit_code": 0, "stdout": "Tests: 14 passed, 14 total\n", "stderr": "", "ms": 9120 }Files
PUT/v1/sandboxes/{id}/files/{path}
GET/v1/sandboxes/{id}/files/{path}
Send and receive the raw bytes. For files over 100 MB, use the SDKs, which split them into parallel chunks.
Pause, resume, snapshot
POST/v1/sandboxes/{id}/pause
POST/v1/sandboxes/{id}/resume
POST/v1/sandboxes/{id}/snapshots
Kill a sandbox
DELETE/v1/sandboxes/{id}
Returns 204. A second call returns 409 conflict.
Was this page helpful?