API Reference

Sandboxes

Method	Endpoint	Description
GET	/api/sandboxes	List sandboxes
POST	/api/sandboxes	Create sandbox
DELETE	/api/sandboxes/:name	Delete sandbox
POST	/api/sandboxes/:name/open	Start port-forward, returns {"port","url"}
GET	/api/sandboxes/:name/download	Download /workspace as tar.gz
WS	/api/sandboxes/:name/ws/:session	WebSocket proxy (session: agent/terminal)

Create Sandbox

POST /api/sandboxes
{
  "name": "my-agent",
  "agent": "claude",
  "config_ids": ["uuid-1", "uuid-2"]
}

Checkpoints

Method	Endpoint	Description
POST	/api/sandboxes/:name/checkpoint	Save checkpoint ({"label":"x"})
POST	/api/sandboxes/restore	Restore from checkpoint
GET	/api/checkpoints	List saved checkpoints

Configs

Method	Endpoint	Description
GET	/api/configs	List configs
POST	/api/configs	Create config
PUT	/api/configs/:id	Update config
DELETE	/api/configs/:id	Delete config

Create Config

POST /api/configs
{
  "name": "production-keys",
  "env_vars": {
    "OPENAI_API_KEY": "sk-...",
    "DATABASE_URL": "postgres://..."
  }
}

Agent REPL

Method	Endpoint	Description
POST	/api/sandboxes/:name/repl	One-shot agent prompt
GET	/api/sandboxes/:name/io-log	Get I/O logs