conversations

Get a conversation

Changed on

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 scope: `inference:run`

get/conversations/{conversation_id}

Request

  • Base URL
    https://developer.qaip.com/api/v1
  • URL
    https://developer.qaip.com/api/v1/conversations/{conversation_id}
  • Auth
    API key in header x-api-key

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

Changes

  • 2489c6f1a9d8Revision changes
    • info

      added the non-success response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

  • b849852eb53bRevision changes
    • info

      endpoint added