Too Many Requests

too-many-requests · 429

The caller sent more requests to this route than its window allows, so the API refused this one without running it.

Each route counts the requests from each client IP address on its own: by default 100 a minute. It is worth retrying, after the wait the response names.

This type adds no members to the ones every error carries.

Common causes

  • A poll loop with no delay between rounds.
  • A retry loop that treats every failure as retryable, and so speeds into the limit.
  • Several workers behind one IP address calling the same route.

How to fix the call

  • Wait for the number of seconds in the Retry-After header, then retry.
  • Put a delay in every poll loop, and lengthen it when the answer hasn't changed.
  • Spread parallel work over time rather than sending it all at once.

Example response

json
{
  "type": "too-many-requests",
  "title": "Too Many Requests",
  "status": 429,
  "detail": "ThrottlerException: Too Many Requests",
  "requestId": "req-1785231000000-4f7b2c9ae",
  "timestamp": "2026-07-28T09:30:00.000Z",
  "path": "/v1/projects",
  "method": "GET",
  "instance": "GET /v1/projects",
  "docs": "https://ghaym.me/docs/errors/too-many-requests"
}