Paraphrase API
All endpoints accept and return JSON. Authentication routes are served by Better Auth under /api/auth.
| Method | Path | Purpose |
|---|---|---|
| GET | /api/v1/health | Liveness, version and deployed build. |
| GET | /api/v1/ready | Current engine tier and LLM provider availability. |
| GET | /api/v1/config | Public settings: quality thresholds, modes, upload limit. |
| POST | /api/v1/humanize-text | {text, mode, strength, language, keep_terms, custom_instructions, length, include_segments} |
| POST | /api/v1/verify-text | Score a candidate against a source without rewriting. |
| POST | /api/v1/jobs | Run a paraphrase in the background → {job_id, status_url, events_url}. |
| GET | /api/v1/jobs/{id} | Job status and result. |
| GET | /api/v1/jobs/{id}/events | Server-sent progress, completed and failed events. |
| GET | /api/v1/reviews/{id} | Review session with word-level changes. |
| POST | /api/v1/reviews/{id}/final | Accept or reject changes and build the final text. |
| GET | /downloads/{name} | Download a generated file until it expires. |
Modes: standard, humanize, fluent, formal, academic, simple, creative, concise, expand. Strength: light, medium, strong.