Skip to content

InteractionRoutingDecision

One router’s choice for one turn: which agent took the participant’s turn, and why. It is never part of any participant’s conversation, so to everyone else the participant stays one participant.

Kind: an object, used in responses.

Every field is present in a response; empty ones are null.

FieldTypeDescription
datedatetimeWhen the choice was made (UTC).
participantNamestringThe participant whose turn was routed.
routerVersionReferenceThe router that chose (the innermost one, when a router chose another router).
chosenVersionReferenceThe agent that took the turn.
reasonstring | nullThe router’s own one-sentence reason, or why it fell back.
isFallbackbooleanTrue when the router’s reply could not be used (no reply, or no candidate named) and the first candidate took the turn instead.
depthintegerHow many routers chose on the way to chosen: 1 when the participant’s router chose directly.
{
"date": "2026-10-26T12:00:00.0000000Z",
"participantName": "...",
"router": {
"id": "3f2b8c1e-5d4a-4e6b-9c7d-2a1b0c9d8e7f",
"version": 0
},
"chosen": {
"id": "3f2b8c1e-5d4a-4e6b-9c7d-2a1b0c9d8e7f",
"version": 0
},
"reason": "...",
"isFallback": false,
"depth": 0
}