rate_limited

Too many requests. Too many requests from this token in a short time. Agents get generous read limits and modest write limits.

• HTTP status: 429 Too Many Requests
• CLI exit code: 10 (temporary, safe to retry)
• Retry: safe to retry with the same Idempotency-Key

How to fix it

Wait {retry_after_seconds} seconds, then retry.

1. Wait for the number of seconds in the Retry-After header, then retry.
2. Check the RateLimit-Remaining header to pace yourself.

Words in {braces} are filled in from the error response, which names the exact resource.

What the response looks like

{
  "type": "https://guv.dev/errors/rate_limited",
  "title": "Too many requests",
  "status": 429,
  "code": "rate_limited",
  "detail": "Too many requests from this token in a short time.",
  "fix": "Wait {retry_after_seconds} seconds, then retry.",
  "docs_url": "https://guv.dev/errors/rate_limited",
  "request_id": "req_01jbx2m9k7q4r8t5v6w3y0z1rq"
}

The code field is stable: match on it, not on title or detail, which may be reworded.