v50

latestOpenAPI 3.1.0raw.githubusercontent.com2026-06-012124381.2 MB

local-sandbox

Acquire a local sandbox

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 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