List all sandboxes

Get all sandboxes associated with the API key’s account. Optionally filter by tag.

GET /sandbox

List all sandboxes

cURL

curl --request GET \
  --url https://api.klavis.ai/sandbox \
  --header 'Authorization: Bearer <token>'

200

{
  "sandboxes": [
    {
      "sandbox_id": "<string>",
      "server_name": "<string>",
      "status": "idle",
      "benchmark": "<string>",
      "tags": [
        "<string>"
      ],
      "updated_at": "2023-11-07T05:31:56Z"
    }
  ],
  "total_count": 123
}

Authorizations

Authorization · string · header · required

Your Klavis AI API key.

Query Parameters

tag · string | null

Optional sandbox tag string to filter by

server_name · string | null

Optional MCP server name to filter by (case-insensitive)

Response

200

application/json

Successful Response

Response model for listing all sandboxes

sandboxes · SandboxListItem · object[] · required

List of sandboxes

Show child attributes

total_count · integer · required

Total number of sandboxes