Get a conversation audit report
GET /api/conversations/{conversationId}/audit
GET
/api/conversations/{conversationId}/audit
Returns a deep audit report for a conversation: metadata, contact and account references, a per-turn trace (messages, orchestrator iterations, specialist executions, tool calls, composed reply), the activity trace, attention items, and identity events.
Authorizations
Section titled “Authorizations ”Parameters
Section titled “ Parameters ”Path Parameters
Section titled “Path Parameters ” conversationId
required
string format: uuid
The conversation id.
Responses
Section titled “ Responses ”The conversation audit report.
object
meta
object
conversationId
string format: uuid
tenantId
string format: uuid
workspaceId
string format: uuid
channelId
string format: uuid
generatedAt
string format: date-time
turnCount
integer
messageCount
integer
executionCount
integer
contact
Contact reference for the conversation.
object
key
additional properties
any
account
Account reference, or null when the contact has no account.
object | null
conversation
object
status
string
outcome
string | null
workflowId
string | null
stateSummary
string | null
createdAt
string format: date-time
lastActivityAt
string format: date-time
turns
Per-turn detail: messages, orchestrator iterations, specialist executions, tool calls, and the composed reply.
Array<object>
object
key
additional properties
any
activityTrace
Workflow activity trace.
Array<object>
object
key
additional properties
any
attentionItems
Array<object>
object
key
additional properties
any
identityEvents
Array<object>
object
key
additional properties
any
warnings
Non-fatal issues encountered while assembling the report.
Array<string>
Conversation not found.
Standard error response returned by all endpoints on failure.
object
error
required
A human-readable error message describing what went wrong.
string
Example
Conversation not found