Evidence Router

Recommend read-only evidence endpoints for a request (never executes, never answers)

Infers which evidence type(s) (resultKind, e.g. time_series, asset_table, market_signal) the request needs, then matches them against a curated read-only endpoint catalog. Recommends one or more approved read-only endpoints with fachliche result semantics, and reports coverage/missing evidence types. Never substitutes an unrelated endpoint when the required evidence type is unavailable (coverage.noSubstitution is always true). Never mutates state, never creates process side effects, never synthesizes the final user-facing answer — that remains the responsibility of the consuming agent/orchestrator. Distinct from the Process Intake / Write Boundary contract (POST /api/copilot-process/intents): this action only ever recommends GET/POST read-only lookups, never process/write intents.

post/api/evidence-router/route

Request

  • Base URL: https://api.cernion.de
  • URL: https://api.cernion.de/api/evidence-router/route
  • Auth: none declared

Query parameters

tokenstring

Optional Cernion MCP token as URL query parameter. If provided, it overrides CERNION_TOKEN for this request. Prefer Authorization Bearer header in production to reduce token exposure in URLs/logs.

Request body

questionstring required

Natural-language request describing the evidence needed.

contextobject

Optional canonical input values (location, dateFrom, dateTo, assetType, ...).

tokenstring

Optional Cernion MCP token for this request. Overrides CERNION_TOKEN when provided.

Example request

{
  "question": "Wie hoch ist die CO2-Intensität in den nächsten 24 Stunden in 69168?"
}

Response

Evidence Router response — recommendation, never an executed result or final answer.

successboolean required
requiredEvidenceTypesstring[] required
nextStepstring required

Example response

{
  "resolved": {
    "kind": "evidence_plan",
    "source": "evidence_router"
  },
  "coverage": {
    "noSubstitution": true
  }
}

Changes

No recorded changes to this operation across all 2 revisions of this API.