Pools

Create a sandbox pool

POST
/sandboxpools

Authorization

ApiKeyAuth
AGENTBOX-API-KEY<token>

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://sandboxpools" \  -H "Content-Type: application/json" \  -d '{    "name": "string"  }'
{  "template": {    "name": "my-pool",    "namespace": "t-team1-user1",    "team": "team1",    "user": "user1",    "cpu": "2000m",    "memory": "4Gi",    "templateVersion": "v1",    "createdAt": "2026-04-21T10:00:00Z"  }}

{  "error": "sandbox template \"default-template\" not found",  "detail": {    "availableTemplates": [      {        "name": "gpu-runtime",        "description": "GPU-accelerated runtime with CUDA 12",        "syncSource": "global"      },      {        "name": "nodejs20",        "description": "Node.js 20 baseline runtime"      }    ],    "hint": "Template not found. Pick a name from availableTemplates, or omit templateName to define the pool inline."  }}

{  "error": "invalid API key"}
{  "error": "pool \"my-pool\" already exists"}
{  "error": "API key required for this operation",  "errorCode": "API_KEY_REQUIRED"}
{  "error": "scale failed: QUOTA_EXCEEDED",  "detail": {    "errCode": "QUOTA_EXCEEDED"  }}
{  "error": "string",  "errorCode": "API_KEY_REQUIRED",  "detail": null}

Report optional features enabled on this cluster GET

Returns boolean switches for each optional feature wired into the current deployment. Clients (dashboard, SDK) use this to decide whether to render feature-specific UI (quota selector on pool create, etc.) and whether the corresponding endpoints are available.

Delete a sandbox pool DELETE

Next Page