rate_limited
Too many requests
HTTP 429rate_limited
You crossed a rate limit. The Retry-After header says how long to wait.
Why it happens
- A burst larger than the account allows, often a backfill or a loop.
- Platform backpressure: under load, bulk traffic is shed before transactional, and transactional before OTP.
How to fix it
- Honour
Retry-Afterrather than retrying immediately, and add jitter so your workers do not synchronise. - Mark traffic honestly with
priority. OTP never queues behind a marketing blast, which only works if you label the blast as bulk.
Is it worth retrying?
Yes, with backoff, reusing the same idempotency key.
What the response looks like
HTTP/1.1 429
Content-Type: application/json
Woyra-Request-Id: req_01J...
{
"error": {
"code": "rate_limited",
"message": "…",
"doc_url": "https://docs.woyra.io/errors/rate_limited",
"param": null,
"request_id": "req_01J..."
}
}