API reference · Schema
SandboxRun
objectstringrequiredAlways `sandbox_run`: the type of this object
One of
sandbox_runidstringrequiredUnique ID (`sbr_…`)
ID with prefix sbr_
sandbox_idstringrequiredID of the sandbox
ID with prefix sbx_
languagestringrequiredLanguage the code ran as
One of
pythonjavascriptshellstatestringrequiredqueued | running | completed (it ran: see exit_code and cut_off) | error (it could not run: see error)
One of
queuedrunningcompletederroroutcomestring | nullrequiredOne word for how it ended (null while queued or running)
One of
succeededfailedtime_limitoutput_limitout_of_memorycancelledsandbox_endederrorexit_codeinteger | nullrequiredExit status of the code (0 means success); null until it finishes, or when it could not run
cut_offstring | nullrequiredWhy it was stopped before it finished: time_limit | output_limit | out_of_memory | cancelled | sandbox_ended
One of
time_limitoutput_limitout_of_memorycancelledsandbox_endedstate_resetbooleanrequiredThe Python interpreter had to be restarted: variables from earlier runs are gone
errorstring | nullrequiredWhy the run could not run or was stopped, for people; null otherwise
stdoutstringrequiredStandard output (see `output.truncated`)
stderrstringrequiredStandard error (see `output.truncated`)
outputobjectrequiredHow much output the run produced
ShowHide 3 fields of
outputstdout_bytesintegerrequiredBytes the run wrote to standard output
stderr_bytesintegerrequiredBytes the run wrote to standard error
truncatedbooleanrequiredstdout and stderr above are the run's whole output (up to its cap) in the response to the run itself, and the first 65536 bytes of each in the record kept for 7 days after the sandbox ends; true when this copy is shorter than what the run produced
codestringrequiredMachine-readable code
timeout_secondsintegerrequiredTime limit the run had, in seconds
max_output_bytesintegerrequiredCap on stdout plus stderr the run had, in bytes
duration_msinteger | nullrequiredHow long it ran, in milliseconds; null until it finishes
created_atstring (date-time)requiredWhen it was created (ISO 8601, UTC)
started_atstring (date-time) | nullrequiredWhen it started (null until then) (ISO 8601, UTC)
finished_atstring (date-time) | nullrequiredWhen it finished (null until then) (ISO 8601, UTC)
{
"object": "sandbox_run",
"id": "sbr_01jc5zq4m8k3v6x9t2w7r0b1e4",
"sandbox_id": "sbx_01jc5zq4m8k3v6x9t2w7r0b1e4",
"language": "python",
"state": "queued",
"outcome": "succeeded",
"exit_code": 1,
"cut_off": "time_limit",
"state_reset": true,
"error": "string",
"stdout": "string",
"stderr": "string",
"output": {
"stdout_bytes": 1,
"stderr_bytes": 1,
"truncated": true
},
"code": "string",
"timeout_seconds": 1,
"max_output_bytes": 1,
"duration_ms": 1,
"created_at": "2026-01-01T00:00:00.000Z",
"started_at": "2026-01-01T00:00:00.000Z",
"finished_at": "2026-01-01T00:00:00.000Z"
}Used by
- Runs of a sandbox, newest first (kept until 7 days after it ends)
GET /v1/sandboxes/{sandbox_id}/runs - Run code in the sandbox and wait for the result (or stream it)
POST /v1/sandboxes/{sandbox_id}/runs - One run: its outcome and recorded output
GET /v1/sandboxes/{sandbox_id}/runs/{run_id} - Stop a queued or running run (a finished run is returned as it is)
POST /v1/sandboxes/{sandbox_id}/runs/{run_id}/cancel