Sessions

Get session capture metadata

Returns CDP-derived capture metadata recorded during a session: ordered events (actions, navigations, network XHR/fetch, console, exceptions, snapshot triggers), the browser context, and the post-session storage state. Only available when the organization has the CDP capture feature flag enabled and the session ran on the desktop VM.

404 is returned when no capture exists for the session.

get/api/sessions/{sessionId}/capture

Request

Path parameters

sessionIdstring uuid required

Query parameters

includeSnapshots'none' | 'metadata' | 'full'

Controls how snapshots[] is returned.

  • none: empty array.
  • metadata (default): each entry has id, ts, messageId, trigger, targetId, url, title, domBytes, axBytes — fetch full content per-snapshot via GET /api/sessions/{id}/snapshots/{snapshotId}.
  • full: includes the full dom and axTree inline (can be multi-MB; avoid for routine MCP/agent calls).
includeCookieValuesboolean

Include cookie values in the capture (true); by default only cookie names and attributes are returned.

Response

Session capture blob.

sessionIdstring uuid required
platformstring required
startedAtstring date-time nullable
endedAtstring date-time nullable
browserContextobject nullable

UA, viewport, locale, timezone captured at session start.

storageStateobject nullable

Cookies and localStorage captured at session end.

snapshotCountinteger required

Number of DOM+AX snapshots captured (one per screenshot tool call and per page-load).

snapshotsPrefixstring nullable

S3 prefix for snapshot blobs. Null while snapshots are persisted inline.

truncatedboolean required

True if the event buffer reached its cap and dropped tail events.

createdAtstring date-time
updatedAtstring date-time

Example response

{
  "platform": "desktop"
}

Changes

No recorded changes to this operation across all 1 revision of this API.