10 articles in this collection
Error envelope
Read HTTP status, stable code, field details, request ID, and retry guidance.
1xxx validation errors
Resolve missing, malformed, conflicting, oversized, unknown, or unsupported input.
2xxx resource and state errors
Resolve permissions, not-found resources, idempotency conflicts, invalid state, consent, and customer-window failures.
3xxx transient errors
Retry unavailable authentication, storage, provider, event, and internal dependencies safely.
4xxx delivery and policy errors
Resolve offline devices, provider rejection, ineligible senders, quotas, and exhausted attempts.
5xxx media errors
Resolve upload, download, type, URL source, readiness, and capacity failures.
Webhook and replay errors
Resolve endpoints, signatures, secrets, cursors, deliveries, replay ranges, and terminal state.
Template and capability errors
Resolve template review, message-part support, chat type, and service capability mismatches.
Payment and reputation errors
Resolve payment state, provider connections, line health, restrictions, and spending controls.
Troubleshooting playbook
Collect safe evidence, stop amplification, reconcile authoritative state, and contact support.