Errors
Relay API error shape and common codes.
Failed requests return JSON { "error": "Human message", "code": "SCREAMING_SNAKE" } with an appropriate HTTP status.
| Code | Typical status | Meaning |
|---|---|---|
| UNAUTHORIZED | 401 | Missing or invalid JWT or org secret. |
| FORBIDDEN | 403 | Valid auth but insufficient role or revoked environment. |
| NOT_FOUND | 404 | Resource not in this organization. |
| VALIDATION_ERROR | 400 | Body or path failed schema validation (ingest handlers). |
| BAD_REQUEST | 400 | Body failed validation (organization handlers). |
| CONFLICT | 409 | Duplicate member, closed session, or idempotency in progress. |
| SESSION_CLOSED | 409 | Session no longer accepts events. |
| IDEMPOTENCY_CONFLICT | 409 | Same idempotency key still processing. |
| SERVICE_UNAVAILABLE | 503 | Unhandled server error. |
Ready to ship?
Get started free