Skip to main content
See Browser for driving the browser itself — actions, close, saved logins. This page is the dashboard’s read of what ran.
Every browser opened beside a computer — by an agent’s browser tool or by POST /v1/computers/{id}/browser/actions — is a browser session row. These routes list a computer’s rows, closed ones included, and mint a live view of one that is still open.

​
The browser session object

The same object Browser returns: id (brw_…), object: "browser_session", computer_id, session_id (the agent session that opened it, or null for one opened over the API), status (creating, active, closed, error), allowed_domains, region, context_id, context_backed, timeout_at, opened_at, closed_at, created_at. It never carries a provider reference.

​
List browser sessions

GET /v1/computers/{id}/browser_sessions — scope computers:write Every browser session opened beside the computer, newest first, closed sessions included. The list is not paginated — a computer drives a handful — so has_more is always false. 404 not_found for a computer that is not yours.

​
Open a live view

POST /v1/computers/{id}/browser_sessions/{bid}/live_view — dashboard session only Mints a short-lived URL that shows the remote browser as it runs. Takes no body. On an API key: 403 forbidden — the same rule as GET /v1/computers/{id}/browser/live-view, which returns the same object for the one browser currently open.
The URL is a bearer credential: anyone holding it controls the browser until it expires, with no further authentication. It is minted on demand for the person looking at the dashboard, never stored, never written to the audit trail, never returned inside any other object, and withheld from the MCP catalogue — the agent that drives the browser never sees its own live view. Hold it in memory, render it, and let it expire.
404 not_found once the session has closed, or for a session that was not opened beside this computer. Audited as browser.live_view_opened — who, when, and for which session, never the URL.