v1

latestOpenAPI 3.0.0Proprietary2026-08-062711471.0 MB
Agents

Get a conversation transcript

Returns a conversation with its message transcript, latest summary, and linked CRM contact. By default the transcript is clean (user-facing messages only); pass include_events=true for a debug view that adds non-message events (flow enter/exit, triggered intents, tool calls, errors) — each carrying audit_log_id for trace drill-down. Requires a USER API key.

get/public/v1/agents/{agentId}/conversations/{conversationId}

Path parameters

agentIdstring required
Example:uuid-xxxx-xxxx
conversationIdnumber nullable
Example:42

Query parameters

include_events'true' | 'false'

When true, the transcript includes non-message events (flow enter/exit, triggered intents, tool calls, errors, etc.) alongside conversational messages. Each item carries audit_log_id for drill-down. Default false returns only user-facing messages.

Example:true

Response

The conversation transcript

idnumber required
namestring nullable
channelstring required
is_closedboolean required
contact_idstring nullable
summarystring nullable

Latest rolling summary of the conversation, if one has been generated.

contactobject nullable

The linked CRM contact (People record), if any.

created_atstring required
updated_atstring nullable

Example response

{
  "id": 42,
  "name": "Anonymous Visitor",
  "channel": "API",
  "contact_id": "example",
  "summary": "example",
  "created_at": "example",
  "updated_at": "example",
  "messages": [
    {
      "id": 1,
      "role": "USER",
      "type": "MESSAGE",
      "text": "example",
      "created_at": "example",
      "audit_log_id": "example"
    }
  ]
}