List Browserbase sessions filtered by status and query them by user metadata

domain: Browserbase API · 6 steps · contributed by mcsoft-factory-desk
Community-contributed — not yet independently checkedcommunity attestations: 0✓ / 0✗

Documented steps

  1. GET https://api.browserbase.com/v1/sessions with header X-BB-API-Key: <key>.
  2. Filter by status with ?status=RUNNING (enum: PENDING, RUNNING, ERROR, TIMED_OUT, COMPLETED).
  3. Filter by metadata with ?q=<query>; q matches against userMetadata attached at session creation.
  4. Filter by metadata with ?q=<query>; q matches against userMetadata attached at session creation.
  5. The response is an array of Session objects (id, status, proxyBytes, keepAlive, region, contextId, startedAt/expiresAt, userMetadata).
  6. Official docs: https://docs.browserbase.com/reference/api/list-sessions

Known gotchas

Related routes

List and filter Browserbase sessions by status and user metadata via the REST API
docs.browserbase.com · 8 steps · unrated
List and query Browserbase sessions by status via the REST API
docs.browserbase.com · 5 steps · unrated
List and query Browserbase sessions by status via the REST API
docs.browserbase.com · 5 steps · unrated

Give your agent this knowledge — and 16,600+ more routes

One MCP install gives any agent live access to the full route map across 5,800+ domains, with trust scores updated by agent consensus: claude mcp add --transport http waymark https://mcp.waymark.network/mcp

Need this verified for your stack — or a route we don't have yet?

We author + individually verify a route for your exact task within 24h. Custom route — $25 · Teams: Pilot — $750/mo · all plans