sessions
List Session Frames
List captured frames for a session, with presigned S3 URLs for the full-res webp and thumbnail.
Designed for post-call agents (e.g. a coding agent given the conversation link) that need to reconstruct the visual context of the call alongside the transcript. Frames are ordered oldest-first by captured_at.
Query params:
- start / end — wall-clock window in seconds (agent clock; same timestamps as the transcript). Both optional.
- limit — max frames to return (default 500, hard cap 2000).
- sources — comma-separated subset of captured frame sources (speaking_tick,motion_spike,turn_end,silent_watch,pointer_trace, etc.).
- user_turn_index — restrict to frames captured during a specific real user turn. Match against transcript[].real_user_turn_index (user rows) or transcript[].responding_to_user_turn_index (assistant rows).
Each frame returns presigned URLs valid for 1 hour. Re-call this endpoint to refresh URLs.
get/v1/sessions/{session_id}/frames
Path parameters
session_idstring required
Query parameters
startnumber nullable
endnumber nullable
limitinteger
sourcesstring nullable
user_turn_indexinteger nullable
Response
Successful Response
{"stackTrail":"paths:/v1/sessions/{session_id}/frames:get:responses:200:content:application/json:schema","oasType":"schema","type":"unknown"}
Changes
No recorded changes to this endpoint across all 1 revision of this API.