conversations
Get the customer-readable trace for a v2 conversation, nested Session→Turn→node→step
The nested tree variant of the session trace (Phase D), paginated by TURN. Same auth (TRACE_READ) + org scoping + terminal-session cache as the flat read. The full tree is built + cached once, then a window of limit turns from cursor is returned with a next_cursor for the next block (None on the last page). header + session lane ride every page.
get/v1/conversations/{conversation_id}/trace/grouped
Path parameters
conversation_idstring uuid required
Query parameters
turn_idstring uuid nullable
cursorstring nullable
Turn-pagination cursor: pass the previous page's next_cursor to load the next block of turns. Omit for the first page.
Turn-pagination cursor: pass the previous page's next_cursor to load the next block of turns. Omit for the first page.
limitinteger
Max TURNS per page (the grouped tree paginates by turn, not by raw step).
Max TURNS per page (the grouped tree paginates by turn, not by raw step).
category'product' | 'engineering' | 'all'
Response
Successful Response