Sign in
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 first page pins the ordered turn roster while every page hydrates current turn content. A window of limit turns is returned with a next_cursor for the next block (None on the last page). If an expired roster changed, the endpoint returns 409 so the client can restart rather than mix traversals. 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

Opaque turn-pagination cursor: pass the previous page's next_cursor to load the next block from the same turn roster. Omit for the first page.

Opaque turn-pagination cursor: pass the previous page's next_cursor to load the next block from the same turn roster. 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

next_cursorstring nullable

Changes

Changed in 2 of the 3 revisions of this API.6

  • 9cd7291d42285See the full diff
    • ○

      added the non-success response with the status 409

      response-non-success-status-added

    • ○

      added the optional property session/items/observation_ids to the response with the 200 status

      response-optional-property-added

    • ○

      added the optional property session/items/truncation to the response with the 200 status

      response-optional-property-added

    • ○

      added the optional property turns/items/groups/items/steps/items/observation_ids to the response with the 200 status

      response-optional-property-added

    • ○

      added the optional property turns/items/groups/items/steps/items/truncation to the response with the 200 status

      response-optional-property-added

    This revision also has 1 change that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

  • 5a5597ebb2d61See the full diff
    • ○

      endpoint added

      endpoint-added

    This revision also has 40 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog