KLklavis-ai
local-sandbox

Acquire a local sandbox

Changed on

Initializes a specialized Virtual Machine environment (Local Sandbox) that hosts multiple interconnected MCP servers. Optionally specify a benchmark (e.g., 'Toolathlon') to configure the sandbox. IMPORTANT: The benchmark parameter may affect BOTH (1) the initial data environment (e.g., preloaded data or pre-configured state for supported servers) AND (2) the MCP server implementation itself — some servers may be routed to a benchmark-specific MCP server with potentially different tools or behaviors.

post/local-sandbox

Request

  • Base URL
    https://api.klavis.ai
  • Auth
    HTTP bearer

Request body

benchmark'MCP_Atlas' | 'Toolathlon' | 'MCP_Mark'

Supported benchmarks for sandbox initial environment

test_account_emailstring nullable

Specific test account email

ttl_secondsinteger nullable

TTL in seconds. The local sandbox will be automatically released after this duration. Default: 7200 (2 hours). Min: 60 (1 minute). Max: 86400 (24 hours). Set to null to disable auto-release.

Response

Successful Response

local_sandbox_idstring required

Unique identifier for the entire local sandbox environment

status'idle' | 'occupied' | 'error'

Status of a sandbox instance - matches database enum

benchmarkstring nullable

Benchmark environment configuration used for the local sandbox

messagestring nullable

Status message

Changes

  • 717d658593eaRevision changes
    • breaking

      response property servers/items/tags list-of-types was widened by adding types array to media type application/json of response 201

    • breaking

      the /// response's property type changed from object to array for status

  • 84dffa426326Revision changes
    • breaking

      removed the enum value playwright_toolathlon of the request property //

    • info

      added the new playwright enum value to the request property //