Skip to main content

Retries & Backoff

The SDK retries automatically on 429 (respecting X-RateLimit-Reset), 500, 502, 503, 504, network errors, and timeouts. Backoff is exponential with jitter, capped at 16s.

The API may set retryable: false on a specific error; the SDK respects that and does not retry.

Rate limit retries respect the X-RateLimit-Reset header from the API, so the SDK waits the exact right amount of time before retrying a 429.