api

Sandboxes API

Method	Path	Notes
`GET`	`/v1/rooms/{room}/sandboxes`	List
`POST`	`/v1/rooms/{room}/sandboxes/from-template`	Create from pool/template
`POST`	`/v1/rooms/{room}/sandboxes/prepare`	Prepare (advanced)
`POST`	`/v1/rooms/{room}/start`	Start prepared sandboxes
`POST`	`/v1/rooms/{room}/sandboxes/{agent}/exec`	Run command
`DELETE`	`/v1/rooms/{room}/sandboxes/{agent}`	Destroy one sandbox

from-template body

{
  "agent_id": "a1",
  "guest_cid": 9100,
  "memory_mib": 256,
  "template_id": "default",
  "env": { "MY_TOKEN": "…" },
  "egress_allowlist": ["example.com"]
}

exec body

{
  "argv": ["echo", "hello"],
  "cwd": "/home/user",
  "timeout_ms": 60000,
  "env": { "MY_TOKEN": "override" }
}