Get local sandbox details

Retrieves details about a local sandbox environment, including its status and all running servers.

GET /local-sandbox/{local_sandbox_id}

Get local sandbox details

cURL

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

200

{
  "local_sandbox_id": "<string>",
  "created_at": "<string>",
  "servers": [
    {
      "id": "<string>",
      "server_name": "<string>",
      "mcp_server_url": "<string>",
      "status": "idle",
      "benchmark": "<string>",
      "updated_at": "<string>",
      "metadata": {},
      "auth_data": {},
      "tags": [
        "<string>"
      ]
    }
  ],
  "status": "idle",
  "benchmark": "<string>"
}

Authorizations

Authorization · string · header · required

Your Klavis AI API key.

Path Parameters

local_sandbox_id · string · required

The ID of the local sandbox to retrieve

Response

200

application/json

Successful Response

local_sandbox_id · string · required

Unique identifier for the local sandbox environment

created_at · string · required

Timestamp when the sandbox was created

servers · LocalSandboxServerItem · object[] · required

List of MCP servers in this sandbox

Show child attributes

status · enum<string> | null

Current status of the local sandbox environment

Available options: idle, occupied, error

benchmark · string | null

Benchmark environment configuration for the local sandbox