View Markdown

rate_limited

HTTP 429 · retryable is true

The account went over a per-minute limit, such as 60 notifications a minute on Free, or over the number of asks or waits open at once. It also answers while an agent is paused after sending 20 near-identical messages within a minute. The Retry-After header says how many seconds to wait. This is the one code that is retryable.

What to do: wait Retry-After seconds and send the same request again, with the same Idempotency-Key. The limits are in Limits and in GET /v2.

The response

Every error comes as application/problem+json; Errors explains each field.

{
  "type": "https://usekabu.com/docs/errors/rate_limited",
  "title": "Rate limited",
  "status": 429,
  "code": "rate_limited",
  "detail": "…",
  "hint": "…",
  "retryable": true,
  "request_id": "req_…",
  "doc_url": "https://usekabu.com/docs/errors/rate_limited"
}