Sandboxes
Browser sandbox sessions for agents and automation.
Sandboxes expose Browserbase-backed browser sessions agents use through the browser_control tool and related canvas blocks. Manage org sandbox inventory from /<orgSlug>/infrastructure/sandboxes.
Endpoints
| Method | Path | Description |
|---|---|---|
GET | /api/v1/sandboxes | List sandboxes for the org. |
GET | /api/v1/sandboxes/:id | Get sandbox status. |
POST | /api/v1/sandboxes/browser | Start a browser sandbox session. |
POST | /api/v1/sandboxes/browser/screenshot | Capture a browser screenshot. |
Browser sessions
POST /api/v1/sandboxes/browser creates or resumes a live browser session. Agents navigate, click, type, and capture output through the browser tool surface; the session record persists in the org sandbox inventory until it expires or is closed.
POST /api/v1/sandboxes/browser/screenshot returns a screenshot of the active browser viewport for debugging or canvas blocks that display live browser state.
Dashboard
The infrastructure sandboxes page shows active sessions, provider linkage, and cleanup status. Operator-wide sandbox management lives under /admin and is not part of this public API reference.