v3

latestOpenAPI 3.1.02026-07-311,4541,5202.3 MB
agents

Conversations Retrieve

Retrieve, update, or delete a single conversation.

GET /agents/conversations/<pk>/ — conversation + message tree PATCH /agents/conversations/<pk>/ — update title DELETE /agents/conversations/<pk>/ — hard delete (CASCADE removes messages)

GET query params: branch_tip (str, optional): Message ID to walk from when reconstructing the active branch. If omitted, defaults to the most recent message. Messages not on the active branch are returned in orphaned_messages.

get/agents/conversations/{id}/

Path parameters

idstring required

Headers

Authorizationstring required

JWT access token or Respan API key

Response

idstring required
titlestring required
created_atstring date-time required
updated_atstring date-time required
truncatedboolean required