Sandboxes

List sandboxes

GET
/sandboxes

Authorization

ApiKeyAuth
AGENTBOX-API-KEY<token>

In: header

Query Parameters

poolName?string

Filter by sandbox pool name.

status?string

Filter by sandbox phase. One of: Idle, Starting, Running, Stopping, Failed.

limit?integer

Maximum number of items to return per page.

Default20
Range1 <= value <= 1000
offset?integer

Number of items to skip before returning results (zero-based).

Default0
Range0 <= value

Response Body

application/json

application/json

application/json

curl -X GET "https://sandboxes"
{  "items": [    {      "sandboxId": "5de15c92-8fb5-440f-a9ea-7f62f734f1b9",      "namespace": "t-team-user",      "poolName": "poolname",      "podName": "poolname-wxtfc",      "status": "Completed",      "claimedAt": "2026-04-07T14:37:54Z",      "startedAt": "2026-04-07T14:37:55Z",      "terminatedAt": "2026-04-07T14:38:10Z",      "recycledAt": "2026-04-07T14:38:11Z",      "durationSeconds": 15,      "cpu": "1",      "memory": "16Gi",      "team": "team",      "user": "user",      "containerImages": {        "sandbox": "docker.io/project/name:tag"      }    }  ],  "total": 0,  "limit": 0,  "offset": 0}
{  "error": "string",  "errorCode": "API_KEY_REQUIRED",  "detail": null}
{  "error": "string",  "errorCode": "API_KEY_REQUIRED",  "detail": null}

Check if all runtime endpoints of a sandbox are ready GET

**DEPRECATED** — will be removed in a future version. Prefer `GET /sandboxes/{sandboxId}` and inspect the returned `sandbox.status` (`Running`) plus `sandbox.endpoints` (non-empty, correct scheme/port) instead. Executes the configured ReadinessProbe for each runtime endpoint and returns the aggregated result. Returns 200 when all probes pass, 503 when one or more probes fail. If a runtime has no ReadinessProbe configured, it is considered ready.

Update sandbox idle timeout PUT

Next Page