docs/api_overview.md

API Overview

The dashboard exposes a FastAPI server with a clean OpenAPI schema. All endpoints return JSON (or a FileResponse for binary assets).

Category	Endpoint	Method	Description
System	/api/system	GET	Returns GPU stats, IP, active config.
Stories	/api/stories	GET	List all markdown stories.
	/api/stories/launch	POST	Trigger a story rendering.
	/api/stories/save	POST	Persist edited markdown.
TTS	/api/tts/preview	POST	Generate a short voice preview (respects engine flags).
Engine Control	/api/engine/control	POST	Enable/disable narration and background‑music.
Live Preview	/api/current_frame	GET	Returns the newest generated frame (or 204).
Assets	/api/assets/{category}	GET	List audio files (music, screams, voices).
Logs	/api/logs	GET	Tail of live_logs.txt.

The OpenAPI schema is available at /openapi.json, Swagger UI at /docs, and ReDoc at /redoc.