Backend API for Loveable frontend. All endpoints are prefixed /api/v1/.
| Method | Path | Description |
|---|---|---|
| POST | /chat | Single-turn conversation — returns AI directive |
| POST | /live_sentence | Stream a sentence — triggers auto-advice when threshold met |
| POST | /coach_advice_now | Force-request an AI directive immediately |
| GET | /session/{id}/live_status | Live dashboard: phase, progress score, behavioral signals |
| GET | /session/{id}/transcript | Full event transcript for a session |
| GET | /session/{id}/review | Mid/post-session overview snapshot |
| GET | /session/{id}/analytics | Full post-session analytics report |
| GET | /token | WebSocket auth token (for future real-time stream) |
| GET | /health | Service health |
| Method | Path | Description |
|---|---|---|
| POST | /audio/transcribe | Full audio file → transcript + auto-forward to session |
| POST | /audio/chunk | Streaming audio chunk → partial transcript |
| GET | /audio/session/{id}/transcript | Assembled transcript for a transcription session |
| DELETE | /audio/session/{id} | Clear a transcription session |
| Method | Path | Description |
|---|---|---|
| GET | /settings/coach/{id}/profile | Fetch coach preferences & settings |
| PUT | /settings/coach/{id}/profile | Update coach preferences |
| POST | /settings/coachee | Register a coachee profile |
| POST | /settings/personalize/chat | Natural-language personalization chat (AI extracts settings) |
| GET | /settings/personalize/{id}/history | Personalization chat history for a coach |
| POST | /settings/session | Register a session for tracking |
| POST | /settings/org | Create an organization |
| PUT | /settings/org/{id}/constraints | Set org-wide AI constraints |
| GET | /settings/analytics/session/{id} | Stored analytics for a session |
| GET | /settings/coach/{id}/learned | AI-inferred preferences from usage behavior |
| Method | Path | Description |
|---|---|---|
| POST | /advisor/chat | Chat with the AI coach supervisor (prep, review, guidance) |
| POST | /advisor/prepare | Pre-session briefing for a coach |
| GET | /advisor/review/{session_id} | Post-session AI review and insights |
| GET | /advisor/performance/{coach_id} | Coach performance analysis over time |
| POST | /advisor/notes | Save a note |
| GET | /advisor/notes/{coach_id} | List notes for a coach |
| DELETE | /advisor/conversation/{coach_id} | Clear conversation history |