Skip to content

Rate limit exceeded ​

429 · RATE_LIMIT_EXCEEDED

The budget for this key, for this minute, is spent.

json
{
  "type": "about:blank",
  "title": "Rate limit exceeded",
  "status": 429,
  "code": "RATE_LIMIT_EXCEEDED",
  "detail": "Quota of 60 write requests per minute exhausted. Retry in 4s."
}

The response carries Retry-After in seconds. The window is fixed rather than rolling, so that value is exact: waiting longer wastes budget, and retrying sooner just spends another rejection.

What to do ​

Sleep for Retry-After, then retry the same request. It is safe to retry a 429 — the request was refused before anything was written.

To stop hitting it at all: batch rather than loop. One call creating 50 links costs one write; fifty calls cost fifty. See Creating links in bulk and Rate limits.

Zefi API v1