v52

latestOpenAPI 3.0.3raw.githubusercontent.com2026-08-0393116227.2 KB
conversations

Get a conversation

Get a conversation's active path (the messages from a leaf back to the root) plus a lightweight tree of all nodes (id/parent_id/role) for branch navigation. Pass leaf_id to preview a specific branch without changing the persisted current leaf.

Required roles: All, App

get/conversations/{conversation_id}

Path parameters

conversation_idstring required

Query parameters

leaf_idstring

Leaf node to build active_path from. When set, returns that branch's path without mutating current_leaf_id (non-destructive preview). When omitted, uses the conversation's current_leaf_id. Must belong to the conversation.

principal_idstring

Scope the target by principal. If omitted, only a conversation with no principal (principal_id is null) is addressed; a conversation whose principal differs yields 404.

Response

Conversation detail (active path + tree)

idstring required
principal_idstring nullable

Authorization principal this conversation belongs to (null if not set).

titlestring nullable
current_leaf_idstring nullable
created_atstring date-time
updated_atstring date-time