Use your provisioned controller origin and read its current capabilities. The Node source
and generated core reference do not establish hosted availability or admission for a plan.
Authenticate and admit
API keys use Authorization: ApiKey; JWTs use Bearer. Verify email before obtaining a
usable key. Sandbox creation separately checks scopes/roles, organization/billing, resources,
region, image and isolation support. A successful request submission is not a working runtime.
Create, execute, inspect
- Retain the original supported create key/body before
POST /api/v1/sandbox/create.
- Retain the returned sandbox ID and inspect status under a bounded startup budget.
- Submit the exact command once with its supported key, and save its execution identity.
- Inspect confirmed exit, unknown/capture status and output; validate actual task artifacts.
- Stop the same runtime, inspect acknowledgement, then verify cleanup/status independently.
Follow the tested HTTP quickstart
for a complete shell program. A lost create response needs original-key recovery and
workspace inspection, not an unconditional new create.
Files and background work
The current Node route is /api/v1/sandbox/{id}/files: POST writes base64 file bytes,
GET reads the requested path, DELETE removes a supported path. /files/list lists a
directory. Earlier /files/write and /files/read reference URLs now redirect to the
correct canonical operation.
Use supervised processes for workers that outlive one command request, and
prepared tasks for private launch/input/result receipts.
Process exit, complete output, and task quality are separate observations.
Recovery and persistence
Execution receipts/replay identify commands that
may have run after a disconnect. Wait/cancel acceptance is not termination proof. Durable
workspaces preserve supported disk state, while REPL/process RAM is lost on pause or pod
replacement. Export results before sandbox expiry.
Use tunnel keys and artifact integrity for sharing,
SDK setup for clients, and
core API references for source-derived schemas. Last modified on October 20, 2026
