Limit and quota errors
429 window, weekly, monthly and team limits, 402 and 403 billing errors, and what to do.
- Can the Model API return window_limit_reached?No. Plan limit errors are for app usage. API calls are only stopped by credits (402), key rate limits or team caps.FAQ
- How should my code handle 429 and 402 billing errors?Branch on error.code: wait Retry-After for rate limits, wait resets_at for plan and team limits, stop and alert on 402.How-to
- I got 403 plan_required or model_not_in_plan from an old tool. What now?Those errors were removed on Oct 31, 2026. Every plan has every model and API access. Update your tool.FAQ
- What are resets_at and Retry-After in limit errors?resets_at is the UTC time the limit clears; Retry-After is the number of seconds until then.Reference
- What does 402 quota_exceeded mean in Code Buckets?Your 1,000,000 Code Buckets tokens for this UTC month are used. Requests resume next month. Contact support for more.Troubleshooting
- What does 402 storage_full mean when uploading?The upload would go past your plan's total Code Buckets storage. Delete files or upgrade to a plan with more storage.Troubleshooting
- What does 429 monthly_limit_reached mean?You've used the Free plan's monthly allowance. It resets on the 1st (UTC). Upgrade for usage that refills every few hours.Troubleshooting
- What does 429 team_daily_quota_reached mean?You're on a team and reached the daily quota your team owner set. It resets daily; ask the owner to raise it.Troubleshooting
- What does 429 team_spend_limit_reached mean?You reached the monthly spending limit your team owner set for you. It resets monthly; the owner can raise it.Troubleshooting
- What does 429 weekly_limit_reached mean?You've used your paid plan's weekly limit. It resets 7 days from your billing date; upgrade for more weekly usage.Troubleshooting
- What does 429 window_limit_reached mean?You've used your current usage window on a paid plan. Wait until resets_at, or upgrade for more usage per window.Troubleshooting
- What does it look like when I hit a limit on Telegram?Cosmos tells you in the chat. Check /usage on Telegram or Billing in the Console to see which limit and when it resets.FAQ
- What happens if my code ignores Retry-After and keeps retrying?Each retry fails the same way until the reset, and it uses your key's per-minute rate limit. Wait for resets_at.FAQ
- What's the difference between rate_limited and a plan limit?rate_limited is about speed: requests per minute per key. Plan limits are about total app usage over a window, week or month.FAQ
Still need help?
Tried the steps above and still stuck? Email us. We usually reply within the first hour, and always within 24 hours. A full support team is with you.
Infrastructure questions, or permanent deletion of your data
infrastructure@clatterlabs.xyzFor deleting your whole account or the data of one service.