Skip to content
For AI agents: a documentation index is available at /llms.txt. Every docs page is also available as markdown: add .md to its URL. To connect, read /agents.md.

Errors

rate_limit_exceeded

Requests are arriving too quickly on this credential.

Status

HTTP 429, title Rate limit exceeded. One of the limits errors. Branch on code, never on the status or the prose.

Retryable: yes. Every body carries this as retryable: true, beside action and remedy: the same request can succeed later, after a backoff or the wait the response names.

Common causes

  • More than the per-key limit of 60 requests per minute, free reads included.

What to do

Action: Wait retry_after_seconds, then retry the same request.

Too many requests on this credential. Wait the seconds in Retry-After and retry.

Example

The body arrives as application/problem+json, with retryable and the remedy above. Most responses add detail about the occurrence, and some add fields of their own.

{
  "type": "https://www.shortsintel.com/docs/reference/errors/rate_limit_exceeded",
  "title": "Rate limit exceeded",
  "status": 429,
  "code": "rate_limit_exceeded",
  "retryable": true,
  "action": "Wait `retry_after_seconds`, then retry the same request.",
  "remedy": "Too many requests on this credential. Wait the seconds in `Retry-After` and retry."
}