Primitive / Router
Choose one legal path
Send application state, up to nine allowed candidates, and one required fallback. Receive the selected candidate ID and reasoning.POST
/api/v1/routeRequest contract
- input contains the current JSON state.
- candidates contains stable IDs and descriptions for allowed actions.
- fallback handles ambiguity and out-of-distribution input.
- metadata carries optional trace context without changing the decision space.
JSONjson
{
"input": {"message": "I was charged twice"},
"candidates": [
{"id": "billing", "description": "Charges, invoices, and refunds"},
{"id": "technical", "description": "Errors, outages, and integrations"}
],
"fallback": {"id": "human_review", "description": "Unclear or out of scope"},
"metadata": {"channel": "support"}
}Use the result
- selected_node_id must match exactly one candidate declared in the request.
- confidence measures decision strength.
- out_of_distribution signals that the fallback should own the request.