What it means
the per-account bucket; retry_after_sec set.
How to handle it
Wait at least retry_after_sec and honor Retry-After before retrying against the bucket in meta.bucket.
Wire contract
| Code | rate_limited |
|---|---|
| Class | rate_limit |
| HTTP status | 429 |
| Meta keys | bucket |
| Raised | Yes |
The response uses the standard {"error": {…}} envelope. Branch on error.code, not the human-readable message. Preserve request_id when reporting a failure.