Skip to main content
Base path: /v1/browserbase

​
POST /projects/:project_id/sessions

Create a session. Request 
{
  "projectId": "proj_xxx",
  "name": "my-session",
  "script": "print('hello')",
  "env": {"FOO":"bar"},
  "region": "sfo",
  "timeoutSec": 600,
  "extensionId": null,
  "contextId": null,
  "agentId": null
}
Response 
{
  "id": "<uuid>",
  "providerSessionId": "...",
  "providerProjectId": "proj_xxx",
  "status": "RUNNING",
  "connectUrl": "wss://...",
  "seleniumRemoteUrl": "https://...",
  "createdAt": "...",
  "userMetadata": {"script": "...", "env": {"FOO":"bar"}}
}

​
GET /projects/:project_id/sessions

List tracked sessions. Query: status, limit, offset

​
GET /projects/:project_id/sessions/:session_id

Get a tracked session and sync latest status/URLs from provider.

​
GET /projects/:project_id/sessions/:session_id/logs

Get provider logs for a session. Optional cursor for pagination.

​
GET /projects/:project_id/sessions/dashboard/stats

Basic aggregate statistics for a project.