Sandbox API
Run agents, benchmarks and untrusted code in isolated sandboxes over one HTTP API.
Sandbox runs code and AI agents in isolated environments and gives you back the results. You send a request; the platform provisions a sandbox, runs the work, scores it if there is a verifier, and keeps the artifacts for you to download.
Everything is one REST API behind a single hostname per environment:
export SANDBOX_GATEWAY_URL="https://sandbox.turing.com" # or your own hostChoose an endpoint
Pick by what you are trying to do. All four are available to every credential.
| I want to… | Endpoint | Python client |
|---|---|---|
| Run a benchmark task and score it | POST /sandbox/harbor/v2/jobs/execute-tasks | run_datapoint(...) |
| Run a coding agent against a repo | POST /sandbox/agent/v1/runs | run_agent(...) |
| Run a snippet of code once, no agent | POST /sandbox/codeedit/v1/executions | run_code_execution(...) |
| See which agents and languages exist | GET /sandbox/v1/catalog | catalog(kind=...) |
If you need a score, a verifier, or a task archive, you want the first one. If you just need output from code, you want the third.
Start here
- Get started — your first request, end to end
- Architecture — components + how requests flow
- Core concepts — jobs, statuses, artifacts, tenancy
- Authentication — credentials and what they can reach
Reference
Every endpoint, with parameters, schemas and examples:
- Benchmarks (Harbor) — run tasks, poll jobs, fetch artifacts
- Agent runs
- Code execution
- Catalog and usage
- Credential administration
- Older Harbor paths — still supported
Machine-readable contracts
Served from the same hostname as the API, so these paths work in every environment.
| Artifact | Path |
|---|---|
| OpenAPI specification | /openapi/sandbox-platform.yaml |
| This documentation | /docs |
| Postman collection | Postman |
Limits worth knowing up front
- Concurrent runs are capped per project. Over the cap, synchronous requests get
429withRetry-After; queued jobs simply wait. - Task archives are capped at 256 MiB compressed and 1 GiB expanded.
- Job records and artifacts expire, so download what you need rather than treating the platform as long-term storage.
Details and every error code: Errors and limits.