Wazapin uses standard HTTP status codes. Each error response includes a detail field you can show to users or log for support.
Common status codes
Invalid payload or query params.
Missing or invalid token.
Token does not have the required permission.
The requested resource does not exist.
The request conflicts with the current resource state.
Validation failed. Check the request payload and field values.
Rate limit exceeded. Retry with exponential backoff.
Unexpected server error. Check the response detail and contact support if it persists.
Error response schema
{
"title": "Bad Request",
"status": 400,
"detail": "to is required"
}Handling guidelines
- Log response body and request metadata for incident tracing.
- Retry only for
429and5xxerrors with exponential backoff. - Do not retry
4xxvalidation errors before fixing payload.