Error Codes
Clear error guidance lowers support tickets and speeds up debugging
Document not only the HTTP status but the operational meaning, likely cause, and recommended recovery path so integrators can resolve failures independently.
Docs mode
Reference and guide
Keep the task clear, the example nearby, and the next step obvious.
401
Unauthorized
The API key or access token is missing, expired, or invalid for the current environment.
403
Forbidden
The key is valid but the request lacks access to the requested scope, sender identity, or tenant resource.
429
Rate limit exceeded
The request volume exceeded the current throughput window for the product or tenant.
503
Route unavailable
The upstream provider or route is degraded. Retry using exponential backoff or switch to queued delivery behavior.