Errors
Alerta errors help operators distinguish authentication, validation, provider, and delivery problems.
Common Status Codes
| Status | Meaning | What to check |
|---|---|---|
400 | Validation failed | Required fields and JSON shape |
401 | Authentication failed | x-api-key and x-api-secret |
403 | Access denied | Organization access and credential scope |
404 | Destination not found | channel, channelRef, or provider binding |
429 | Rate limited | Request volume and retry timing |
5xx | Temporary service or provider issue | Retry with backoff after checking provider status |
Example Error
POST /v2/discord/send
{
"statusCode": 400,
"message": "channelRef is required",
"error": "Bad Request"
}
Do not retry authentication or validation errors until the request has been corrected.