API Reference
=============

All API endpoints are served under the ``/api`` prefix via Django Ninja.

Endpoints
---------

.. list-table::
   :header-rows: 1
   :widths: 10 30 60

   * - Method
     - Path
     - Description
   * - GET
     - ``/api/health``
     - Health check
   * - POST
     - ``/api/ask``
     - Ask a question (JSON response)
   * - POST
     - ``/api/ask/stream``
     - Ask a question (SSE streaming)
   * - POST
     - ``/api/sessions``
     - Create a conversation session
   * - POST
     - ``/api/feedback``
     - Submit thumbs up/down on an answer
   * - GET
     - ``/api/verses``
     - List verses (filter by chapter)
   * - GET
     - ``/api/verses/themes``
     - List thematic categories
   * - GET
     - ``/api/verses/{ch}/{v}/related``
     - Related verses by embedding similarity
   * - GET
     - ``/api/answers/{id}``
     - Get a single answer (for shareable pages)
   * - POST
     - ``/api/tts``
     - Text-to-Speech -- returns MP3 audio
   * - POST
     - ``/api/site-feedback``
     - Submit site feedback (name, optional email, message)
   * - GET
     - ``/api/packs``
     - Offline Q&A packs