API_SPEC.md

Fuzzy LangGraph API

GET /health

Returns service status, ingested document count, and graph readiness.

POST /ingest

{
  "replace": true,
  "documents": [
    {
      "id": "doc-1",
      "text": "The current access code is BRAVO-9.",
      "title": "Current notice",
      "source": "official",
      "authority": 0.98,
      "freshness": 1.0,
      "reliability": 0.95,
      "metadata": {}
    }
  ]
}

POST /query

{"question":"What is the current access code?","k":4}

The request executes the compiled LangGraph flow retrieve -> assess -> generate|expand|abstain and returns the final state including answer, citations, confidence, route, reason, and evidence.