API reference
Sandboxes
15 operations. Each page has the request, the response, the errors and examples in curl, TypeScript, Python and the CLI.
- GETSandbox sizes with their prices, and the limits that apply to sandboxes and runs
/v1/sandboxes/sizes - GETList sandboxes in the project, newest first (ended ones only when asked for)
/v1/sandboxes - POSTCreate a sandbox (launch gate and quotas apply); it ends by itself at its deadline
/v1/sandboxes - GETGet a sandbox: its state, time left and cost so far
/v1/sandboxes/{sandbox_id} - POSTMove its deadline later (never past its maximum lifetime)
/v1/sandboxes/{sandbox_id}/extend - POSTEnd a sandbox now: runs are cut off, its files are deleted, billing stops
/v1/sandboxes/{sandbox_id}/end - GETRuns of a sandbox, newest first (kept until 7 days after it ends)
/v1/sandboxes/{sandbox_id}/runs - POSTRun code in the sandbox and wait for the result (or stream it)
/v1/sandboxes/{sandbox_id}/runs - GETOne run: its outcome and recorded output
/v1/sandboxes/{sandbox_id}/runs/{run_id} - GETA run’s output as a server-sent event stream, from its start until it ends
/v1/sandboxes/{sandbox_id}/runs/{run_id}/events - POSTStop a queued or running run (a finished run is returned as it is)
/v1/sandboxes/{sandbox_id}/runs/{run_id}/cancel - GETList a directory of the sandbox’s workspace
/v1/sandboxes/{sandbox_id}/files - DELETEDelete a file, or a directory with everything in it, from the workspace
/v1/sandboxes/{sandbox_id}/files - GETDownload a file from the sandbox’s workspace (streamed)
/v1/sandboxes/{sandbox_id}/files/content - PUTUpload a file into the sandbox’s workspace (replaces it; parents are created)
/v1/sandboxes/{sandbox_id}/files/content