Errors & status codes
API status codes, retry semantics, and common root causes.
| Status | Meaning |
|---|---|
| 200 | OK |
| 400 | Bad payload / invalid language code / unknown action |
| 401 | Missing/invalid API key or session |
| 403 | Plan limit, missing API scope, public key on write |
| 404 | Unknown project, manifest, or endpoint |
| 409 | Conflict — duplicate key on idempotency-key |
| 429 | CDN rate, monthly quota, or AI cooldown |
| 500 | Server error — retry with backoff |
| 502/503 | Gateway / upstream — retry with backoff |