Home Restrictions & limits What should I do after a rate-limit or too-many-requests error?

What should I do after a rate-limit or too-many-requests error?

Last updated on Oct 04, 2026

Read the returned error and any Retry-After instruction before retrying. A request-rate limit, a number's sending restriction, and an exhausted spending budget are different constraints. Increasing concurrency can make a rate-limit problem worse.

Reduce or pause the retrying workload and retain request references for a small sample. For supported idempotent actions, preserve the same key on a retry. If the indicated wait has passed and the same refusal continues, report the endpoint, safe error code, time range, and request rate to support. Do not include credentials.