API_SPEC.md

Fuzzy LangChain API

GET /health

Returns service status and number of ingested documents.

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 response contains answer, citations, confidence, margin, decision, reason, and ranked evidence.