NeoSyntropyAPI

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/route

Request 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.