Errors
HTTP status codes, error responses, and authentication errors.
Errors
HTTP Status Codes
| Status | Meaning |
|---|---|
200 | Success |
400 | Bad request — invalid payload or missing required fields |
401 | Unauthorized — missing or invalid API key |
404 | Not found — resource does not exist |
422 | Unprocessable — validation failed |
500 | Server error |
Error Response Format
{
"error": "<error-message>",
"details": {}
}Authentication Errors
| Scenario | Expected behavior |
|---|---|
Missing Authorization header | 401 Unauthorized |
| Invalid API key | 401 Unauthorized |
Webhook Retry Policy
Webhooks are delivered via Svix. If your endpoint does not return a 2xx response within 15 seconds, Svix will retry delivery. See the Svix retry documentation for the full retry schedule.