Skip to main content
GET
Retrieve the routing trace for a conversation

Authorizations

Authorization
string
header
required

A workspace API token. Create one in Settings → API. Send it as Authorization: Bearer sk_live_....

Path Parameters

conversation_id
string
required

Unique identifier for a conversation.

Pattern: ^conv_[0-9a-f]{32}$
Example:

"conv_9f2ac41d8b7e4a51b0d3e6f7a1c2d3e4"

Query Parameters

since
string<date-time> | null

Only decisions recorded at or after this time. Without it the trace covers every run on the conversation, which on a long thread is a great deal of history.

Response

Successful Response

Why the agent went where it did, on one stretch of a conversation.

conversation_id
string
required

Unique identifier for a conversation.

Pattern: ^conv_[0-9a-f]{32}$
Example:

"conv_9f2ac41d8b7e4a51b0d3e6f7a1c2d3e4"

run_ids
string[]
required

The AI runs this trace covers. A single turn spans several when the agent replans.

Unique identifier for an inference run.

Pattern: ^run_[0-9a-f]{32}$
decisions
RoutingDecision · object[]
likely_cause
string | null

Set when edges lost because a field they compare was never collected — the answer to 'why is it stuck here'.

object
string
default:conversation_trace
Allowed value: "conversation_trace"