Errors
rate_limited
429 — Too many requests for this endpoint
What happened
You sent more requests to this endpoint than its per-minute allowance permits.
Why it usually happens
The allowance is counted per key, per endpoint group, over a 60-second sliding window. Creating an audience, an experiment or an experiment metric is limited to 60 requests per minute per key. Reading a report is not rate-limited.
How to fix
- Wait the number of seconds given in the
Retry-Afterresponse header, then retry. - Read
x-ratelimit-remainingon every response and slow down before it reaches0. - Treat
x-ratelimit-resetas the unix timestamp, in seconds, at which the oldest request leaves the window. - Cache results that do not change every minute rather than re-querying.
- Spread scheduled jobs out instead of firing them all on the minute.
Headers
| Header | Meaning |
|---|---|
x-ratelimit-limit | Requests allowed per minute for this endpoint group |
x-ratelimit-remaining | Requests left in the current window |
x-ratelimit-reset | Unix seconds when the window frees up |
Retry-After | Seconds to wait before retrying (429 only) |
Envelope
{
"error": {
"code": "rate_limited",
"message": "Rate limit exceeded: 10 requests per minute for this endpoint. Retry shortly.",
"param": null,
"doc_url": "https://docs.fullvision.io/errors/rate_limited",
"trace_id": "tr_01HXYZ..."
}
}