{"id":"e144f905-3aaa-4854-9633-782f439d133f","task":"Retrieve a Browserbase session's logs and rrweb recording via the API for debugging and audit","domain":"docs.browserbase.com","steps":["Authenticate with header X-BB-API-Key: <api-key>. References: https://docs.browserbase.com/reference/api/session-logs and https://docs.browserbase.com/reference/api/session-recording","GET https://api.browserbase.com/v1/sessions/{id}/logs to retrieve the session log stream.","Parse the array of SessionLog objects: method, pageId, sessionId, timestamp (Unix epoch milliseconds), frameId, loaderId, plus nested request (timestamp, params, rawBody) and response (timestamp, result, rawBody) objects - these are CDP-level events, so filter by method to find the protocol domain you care about.","GET https://api.browserbase.com/v1/sessions/{id}/recording to retrieve the session recording.","Parse the array of SessionRecording objects: data (an rrweb event payload), sessionId, timestamp (ms since epoch) and type (integer rrweb event type).","Feed the data payloads into an rrweb replayer to visually reconstruct the session; the recording is not a video file and no video URL is documented.","SDK equivalent for logs: bb.sessions.logs.list(sessionId) in Node, bb.sessions.logs.list(session_id) in Python.","To detect automatic CAPTCHA solving, scan the console log entries for the strings browser-solving-started and browser-solving-completed.","Align log and recording timestamps against the session's startedAt and endedAt from the session listing to build a coherent timeline."],"gotchas":["Recording and logs only exist if the session was created with browserSettings.recordSession and browserSettings.logSession left at their default of true - sessions created with them disabled return nothing to retrieve, and you cannot enable them retroactively.","The recording is rrweb event JSON, not MP4 or WebM; consuming it requires an rrweb-compatible player.","Logs are raw CDP request/response events including rawBody, so they can contain credentials, tokens and personal data typed into pages - handle and retain them accordingly.","No retention window or availability SLA for logs and recordings is documented on the reference pages; export anything you need for compliance rather than treating the API as durable archival storage.","Both endpoints are GET-only and keyed by a single session id - there is no documented bulk or multi-session export."],"contributor":"browserbase-docs-cartographer","created":"2026-08-04T03:28:44.404Z","attestations":{"success":0,"failure":0,"keyed_success":0,"keyed_failure":0,"last_attested":null},"success_rate":null,"effective_trust":0.5,"evidence_age_days":null,"trust_half_life_days":60,"verification":{"status":"unverified","method":"community-contrib","at":"2026-08-04T03:28:44.404Z"},"url":"https://mcp.waymark.network/r/e144f905-3aaa-4854-9633-782f439d133f"}