List conversation identity events

GET

/api/conversations/{id}/identity-events

• Production

Returns the identity and verification events recorded during a conversation. These form the audit trail for how a caller was identified and verified across turns, including factor collection and assurance decisions.

Authorizations

• bearerAuth

Parameters

Path Parameters

id

required

string format: uuid

The unique identifier of the conversation.

Responses

200

The identity events for the conversation.

The list of identity events recorded for a conversation.

object

events

required

The identity events for the conversation.

Array<object>

A single identity or verification event recorded during a conversation. Events capture how a caller was identified and verified across turns, forming the audit trail for factor collection and assurance decisions.

object

id

required

Unique identifier for the event.

string format: uuid

Example

ie1a2b3c-5678-9abc-def0-1234567890ab

tenantId

required

The tenant this event belongs to.

string format: uuid

Example

a0b1c2d3-4567-89ab-cdef-0123456789ab

conversationId

required

The conversation this event belongs to.

string format: uuid

Example

c1a2b3c4-5678-9abc-def0-1234567890ab

turnId

The conversation turn during which the event occurred, when applicable.

string | null format: uuid

occurredAt

required

Timestamp when the event occurred.

string format: date-time

Example

2026-03-25T11:40:00.000Z

eventType

required

The kind of identity event, such as a factor being collected or a verification being evaluated.

string

Example

assurance_level_reached

factorCategory

The category of the identity factor involved, when applicable.

string | null

factorType

The specific factor type involved, when applicable.

string | null

factorBoundToPrincipal

The principal the factor was bound to, when applicable.

string | null

derivedAssuranceLevel

The assurance level derived from the collected factors, when computed.

string | null

Example

high-assurance

scopeDimension

The dimension the resulting scope applies to, when applicable.

string | null

Example

assurance_level

scopeValues

The values of the scope dimension, when present. A list of strings, such as the assurance level reached; when an operator joins a call, an object with call_id and operator_user_id.

array | object | null

Example

[
  "high-assurance"
]

evidenceRef

Reference to supporting evidence for the event, when recorded.

string | null

promptVersion

The prompt version used when the event was produced, when applicable.

string | null

questionText

The verification question presented, when applicable.

string | null

sourceToolName

The tool that produced the event, when applicable.

string | null

evaluationSummary

A short summary of the evaluation outcome, when applicable.

string | null

createdAt

required

Timestamp when the event row was created.

string format: date-time

Example

2026-03-25T11:40:00.000Z

404

No conversation exists with the given ID in the authenticated tenant. 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"
]