API Reference

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

Endpoints

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