Base URL
Authentication
| Method | Header | Used for |
|---|
| JWT Bearer | Authorization: Bearer <token> | Dashboard endpoints |
| API Key | X-Api-Key: <key> | Send endpoints (/v1/notify/*) |
All responses are JSON. Successful responses return the resource directly (no envelope), except for auth endpoints which use { success, data }.
HTTP status codes
| Code | Meaning |
|---|
200 | OK |
201 | Created |
202 | Accepted (message queued) |
204 | No Content |
400 | Bad Request — validation error |
401 | Unauthorized — missing or invalid credentials |
403 | Forbidden — insufficient permission |
404 | Not Found |
409 | Conflict — duplicate idempotency key |
422 | Unprocessable Entity — semantic validation failure |
429 | Too Many Requests — rate limit hit |
500 | Internal Server Error |
Endpoints