rate_limit_exceeded (429)

← Error reference

rate_limit_exceeded

HTTP status: 429

Retryable: Yes — the request did not change server state.

The caller exceeded its rate limit.

When it fires

Each org has a per-key request budget per minute. The response includes a `Retry-After` header with the seconds to wait.

How to handle it

Respect `Retry-After`. The official SDK does exponential backoff with jitter automatically. For sustained traffic, request a higher limit via support.

Example response

{
  "error": {
    "type": "https://docs-dev.autohost-dev.uk/api/errors/rate_limit_exceeded",
    "code": "rate_limit_exceeded",
    "message": "Rate limit exceeded; retry after 12 seconds",
    "request_id": "req_01HEXAMPLE0000000000000000",
    "doc_url": "https://docs-dev.autohost-dev.uk/api/errors/rate_limit_exceeded"
  }
}