Skip to main content
GET
Get trace by interaction

Authorizations

Authorization
string
header
required

Access token from POST /management/v1/auth/token (publishable-key exchange) or a login session. Publishable-key tokens are agent-scoped and serve the messaging surface; login tokens also serve management.

Path Parameters

interactionId
required
Pattern: ^[0-9a-fA-F]{24}$

Query Parameters

thread_id

The thread the interaction belongs to. Required for interactions of agents on runtime v2 (dashed-UUID ids); ignored for runtime v1.

Pattern: ^[0-9a-fA-F]{24}$

Response

Successful Response

The reasoning trace of one interaction of an agent on runtime v1 — what the agent understood, which rules fired, and the decisions it took.

runtime
string
default:v1

Which runtime produced this trace; decides the shape that follows.

Allowed value: "v1"
input
TraceInput · object | null
understanding
TraceUnderstanding · object | null
decisions
TraceDecision · object[] | null
computed_parameters
TraceComputedParameter · object[] | null
response
TraceResponse · object | null
rules_evaluations
TraceRuleEvaluation · object[] | null