Execute a command against a browser session
Run a single agent-browser command (navigate, back/forward, screenshot, tab management, storage/cookies, evaluate, …) against an existing session daemon and return its verbatim result envelope. This is the control surface behind the standalone browser dashboard.
Isolation is by sandbox scoping: session_ref must resolve to a live
daemon inside the caller’s own sandbox (resolved from their
credentials), so a caller can only drive sessions they own. argv is
forwarded verbatim to the daemon.
Only the daemon’s structured result is returned — never transport URLs,
API keys, cookies, or other sandbox secrets. A non-zero command exit is
still returned as HTTP 200 with success: false in the envelope.
Authorizations
JWT authentication token
Path Parameters
Opaque browser session reference (brs_)
Query Parameters
Optional project ID for project sandbox scope (requires membership)
Body
Response
The command's verbatim result envelope
Whether the command executed successfully (exit code 0).
Structured command result (shape varies by command); absent when the command emits no JSON.
Error detail when the command failed.
Process exit code of the command.
Raw stdout when the command did not emit structured JSON.

