The HTTP status code is the authoritative signal.
code and status
duplicate it for clients that cannot easily inspect HTTP headers.Standard error responses
Validation errors (422)
When validation fails the server returns422. Each key in info.errors
is the failing field name; the value is an array of error strings:
Retry guidance
4xx— client problem, fix the request before retrying.429— the exception to4xx: do not change the request, wait for the limit’s window to pass and send it again. The endpoint’s description names the window (for example 5 minutes for two-factor codes).5xx— transient server problem. Retry with exponential backoff (start 1 s, max 60 s, add 0–25% jitter).GETandPUTon a known resource are always safe to retry.