v1

latestOpenAPI 3.1.0raw.githubusercontent.com2026-06-304917042.1 MB
runtime v2

List a v2 conversation's transcript

get/v1/v2/conversations/{conversation_id}/turns

Path parameters

conversation_idstring uuid required

Query parameters

limitinteger
cursorstring nullable
rolestring nullable
include_compactedboolean

Include rows folded into the rolling summary by compaction; folded rows carry is_compacted=true so clients can badge them.

Include rows folded into the rolling summary by compaction; folded rows carry is_compacted=true so clients can badge them.

include_evidenceboolean

[ENG-670 T3] Attach each row's evidence package (the KB sources shown to the model). Off by default — the hot read DEFERS the large citations column; opt in to load and project it.

[ENG-670 T3] Attach each row's evidence package (the KB sources shown to the model). Off by default — the hot read DEFERS the large citations column; opt in to load and project it.

evidence_view'display' | 'full'

Serialization view when include_evidence=true. The transcript default is 'full' (staff/audit — raw scores, hashes, chunk ids, status_reason); 'display' is the end-user source-card subset. (The live-turn surface defaults to 'display' instead.)

Serialization view when include_evidence=true. The transcript default is 'full' (staff/audit — raw scores, hashes, chunk ids, status_reason); 'display' is the end-user source-card subset. (The live-turn surface defaults to 'display' instead.)

Response

Successful Response

next_cursorstring nullable
has_moreboolean required