List browser sessions
List the authenticated user’s browser sessions.
Browser session state is owned by the user’s sandbox (the redacted
manifests at /workspace/tasks/{threadId}/browser-session.json). This
endpoint is a stateless proxy: it resolves the user’s sandbox and
forwards the listing. Neo never persists browser session state.
Only opaque references (sessionRef, profileId) and redacted provider
metadata are returned — never transport URLs, API keys, cookies, or
auth headers.
Scope:
- Without project_id: the user’s personal sandbox
- With project_id: the project sandbox (requires project membership)
Authorizations
JWT authentication token
Query Parameters
Optional project ID to list sessions on the project sandbox (requires membership)
Optional task thread ID to filter sessions to a single task
When true, return only sessions with status=active
Response
List of redacted browser session manifests
'cloud' (Kernel/Browserbase) or 'local' (sandbox).
"cloud"
Opaque Neo-issued reference (brs_) exposed to UI/agents.
"brs_0f1e2d3c4b5a69788796a5b4"
Lifecycle status: 'active', 'closed', or 'error'.
"active"
Task thread this session belongs to.
Sandbox directory for session artifacts (e.g. screenshots).
Open tabs captured from the live session, used to restore the working set when a cloud session resumes to about:blank. Sandbox-resident only.
ISO timestamp when the session was first created.
'agent' or 'ui'.
'chrome' or 'lightpanda' (local only).
"chrome"
User-assigned display name for UI-created sessions.
"MetaMask login"
ISO timestamp the session was last attached/resumed.
ISO timestamp the tab set was last captured.
Sandbox-relative manifest path (audit/debug; no secrets).
Reusable profile reference; absent for ephemeral/isolated sessions.
Manifest schema version.
Full initial URL a UI session was created with (UI sessions only).
"https://app.uniswap.org"
ISO timestamp when the manifest was last written.
Owning user id.

