Apian Labs Relay normalizes provider failures into consistent error categories so you can automate retries and triage issues quickly. This page explains the categories you will see in traces and webhook events.

Retryable categories

timeout - provider did not respond within the configured window
provider_5xx - provider returned a server error
rate_limited - provider enforced a rate limit

Non-retryable categories

invalid_destination - destination number failed validation
blocked_sender - sender is not approved or is blocked by the provider
policy_exhausted - routing policy exhausted all options

How to use the taxonomy

Use error categories to alert on provider health and to differentiate policy issues from upstream outages. Apian Labs Relay includes the normalized category in traces and webhook payloads.

Next steps

Troubleshooting