Errors

rate_limited

429 – Rate limited. The caller has made more requests in the window than the limit allows.

Rate limited. Answered with 429.

What it means

The caller has made more requests in the window than the limit allows. The limits exist to take the speed out of a loop – creating Identities, checking Handles, reading public profiles – rather than to meter precisely.

What to do

Back off and retry; honour the Retry-After header if present.

The body

{
  "type": "https://tigby.eu/problems/rate_limited",
  "title": "Rate limited",
  "status": 429,
  "detail": "…what was refused, naming this request's own values",
  "code": "rate_limited",
  "doc_url": "https://docs.tigby.eu/errors/rate_limited",
  "agent_hint": "…the next step, for software"
}

Branch on code. The detail names this request's own Handle, id or limit and is not part of the contract.