Get a conversation audit report

GET

/api/conversations/{conversationId}/audit

• Production

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

• bearerAuth

Parameters

Path Parameters

conversationId

required

string format: uuid

The conversation id.

Responses

200

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 derived from the durable conversation event log (event-bearing and degraded steps only).

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>

404

Conversation not found. An API key restricted to a brand or workspace receives the same answer for a conversation in a workspace outside its restriction.

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

code

A machine-readable reason on some refusals, for example ‘key_lock’ when an API key’s brand or workspace restriction does not cover the action.

string

Example

key_lock

missing_scopes

On a 403 for an API key without a scope the endpoint requires: the scopes the key lacks.

Array<string>

Example

[
  "mcp:write"
]

entryId

On a 409 with code duplicate_question or duplicate_rule_text: the knowledge base entry or policy that already holds the question or rule text.

string format: uuid

Example

11223344-5566-4788-99aa-bbccddeeff00

connectionId

On a 422 about one MCP connection a request names, from an assignment or an agent create or update (a connection that does not exist, one listed twice, or one that does not declare a tool named): the connection, as the request named it.

string

undeclaredTools

On the same 422: the tool names the connection does not declare.

Array<string>

Example

[
  "get_orders"
]

declaredTools

On the same 422: the tools the connection declares.

Array<string>

Example

[
  "get_order",
  "search_orders"
]