Sandbox API

Postman collection

Download a collection covering every route the platform serves, with job ids that chain between requests.

The collection covers every operation in this reference — CodeEdit, the agent runtime, and Harbor — grouped so you can find things without hunting numbered folders.

Download

FileWhat it is
CollectionThe requests. Import this once.
Dev environmentPoints at sandbox-dev.turing.com. Start here.
Prod environmentPoints at sandbox-task.turing.com.
Local environmentFor make up on your own machine, with local dev credentials filled in.

In Postman: Import → drop in the collection and one environment → select that environment in the picker at the top right.

First five minutes

  1. Paste your platform key into SANDBOX_API_KEY. Sandbox Dev already sets tenant_id / project_id. Override only if you use a different project.
  2. Open Start here → Quickstart and send top → bottom.
  3. For admin work, set SANDBOX_ADMIN_API_KEY and use Admin.

You do not need a KeyHive URL. Provision keys under Admin.

Set new_tenant_id / new_project_id to the project you manage (e.g. meta / multi-agent-swarm). Consumer routes auto-activate new_* when they differ from tenant_id / project_id. GET /providers items have source: tenant only — provision each provider under your tenant:project (no shared fallback).

Folders

FolderCovers
Start hereQuickstart, gateway health/docs, auth samples
AdminKeys & quotas, onboard a new tenant:project
HarborOps, v2 (preferred), v2 deliver, v1, unversioned
SSELive Harbor/Agent job event streams (Send and Download)
AgentCatalog, runs, status, events, options
Code EditCatalog + code executions
SandboxesLong-lived sandbox lifecycle
LocalDirect service ports — make up only

Authentication

Every request inherits X-Api-Key: {{SANDBOX_API_KEY}}. A team token works as Authorization: Bearer {{KEYHIVE_TEAM_TOKEN}} (Start here → Auth).

Admin routes need SANDBOX_ADMIN_API_KEY.

Running a Harbor datapoint

Set task_archive_url to an HTTPS zip the cluster can fetch (presigned GCS/S3). Use Harbor → v2. See the Harbor datapoint guide.

Keeping it current

The collection is generated from the same OpenAPI document as this reference. Regenerate with make docs / make postman.