Concepts
Rate Limiting
Understand API rate limits and how to handle them.
API requests are rate limited per API key to ensure fair usage and platform stability.
Your Rate Limits
Rate limits vary by your Cue subscription plan. Check your dashboard at Settings → Usage to see your current limits and usage.
Rate Limit Headers
Every API response includes headers showing your current rate limit status:
| Header | Description |
|---|---|
X-RateLimit-Limit | Your requests per minute limit |
X-RateLimit-Remaining | Requests remaining in current window |
X-RateLimit-Reset | Unix timestamp when the window resets |
Handling 429 Errors
When you exceed your rate limit, the API returns a 429 Too Many Requests response:
{
"error": "Rate limit exceeded. Try again in 45 seconds."
}Best practice: Check X-RateLimit-Remaining and slow down before hitting the limit. If you receive a 429, wait until X-RateLimit-Reset before retrying.