# API Guide

Base path: `/api/v1`

All JSON responses follow:

```json
{
  "success": true,
  "message": "Transcript created",
  "data": {}
}
```

## Auth

- `POST /auth/register`
- `POST /auth/login`
- `POST /auth/refresh`
- `GET /auth/me`
- `POST /auth/logout`
- `PATCH /auth/profile`
- `PATCH /auth/password`
- `POST /auth/forgot-password`

## Audio And Transcription

- `POST /audio/transcribe` accepts multipart field `audio`
- `GET /transcriptions/:id/status` returns queued, processing, completed, or failed
- `GET /transcriptions/whisper/health` checks Whisper VM and queue state

## Transcripts

- `GET /transcripts`
- `GET /transcripts/inbox`
- `GET /transcripts/sent`
- `GET /transcripts/:id`
- `PATCH /transcripts/:id`
- `DELETE /transcripts/:id`
- `POST /transcripts/send`
- `GET /transcripts/:id/audio`
- `GET /transcripts/:id/download`

## Users

- `GET /users?q=kevin`