rate_limit_exceeded

Too many requests per minute

HTTP status

429

Error type

rate_limit

What it means#

You exceeded the per-minute request rate for your plan.

What to do#

Honour the Retry-After header — it is in seconds and it is authoritative. Retrying sooner will not succeed and consumes rate budget you would rather spend on real calls.

Back off exponentially with jitter. Fleets that retry on a fixed interval synchronise into a thundering herd and starve themselves.

This is a rate limit, not a quota — nothing has been consumed and nothing was billed. Simply slow down.

The error shape#

{
  "error": {
    "type": "rate_limit",
    "code": "rate_limit_exceeded",
    "message": "\u2026",
    "doc_url": "https://docs.grahvani.in/errors/rate_limit_exceeded",
    "request_id": "req_01JQ8ZK3M4N5P6Q7R8S9T"
  }
}

Full list: all error codes · error handling guide.