Code Buckets
Plans
Code Buckets storage plans: Free, Starter, Pro and Business, with storage, public traffic and backups.
Code Buckets has its own storage plans. Each one sets how much you can store across all your buckets, how much public traffic your files can serve each month, and how your buckets are backed up.
Plans
| Free | Starter | Pro | Business | |
|---|---|---|---|---|
| Price | $0 | $3 / month | $8 / month | $20 / month |
| Storage (all buckets) | 2 GB | 50 GB | 250 GB | 1 TB |
| Public traffic per month | 10 GB | 100 GB | 1 TB | 5 TB |
| Backups | 1 manual backup | Daily, newest 7 kept | Daily, kept 30 days | Daily, kept 30 days |
| Manual backups | 1 | Up to 10 | Up to 10 | Up to 10 |
| Team, SLA and priority support | — | — | — | Included |
| Extra usage | Hard limit | With credits | With credits | With credits |
Every plan keeps the same per-bucket and API limits: buckets hold up to 10 GB each, and API requests use tokens.
What counts
- Storage is every stored zip and asset in all your buckets, plus uploads you started but haven't completed yet. Deleted files stop counting right away.
- Public traffic is the data your public links send, in a UTC calendar month. Downloads through the API and the Console don't count as traffic (API downloads use tokens).
When you reach a limit
On Free, and on a paid plan with no credits, the limits are hard:
- An upload that would take you past your storage answers
402 storage_quota_exceededwithused_bytes,limit_bytesand anupgrade_url. Files you already have stay readable and downloadable; only new uploads are blocked. - When the month's public traffic is used up, public links answer
429with aRetry-Afterheader until the next month or until you upgrade.
On Starter, Pro and Business, you can go past the limits when your account has credits. Extra usage is charged from your credits once a day:
| Extra usage | Price |
|---|---|
| Storage above your plan | $0.02 per GB per month, charged per day |
| Public traffic above your plan | $0.01 per GB |
When your credits run out, the hard limits above apply until you add credits.
With an AI plan
Your Clatter Labs AI plan also includes storage. Code Buckets uses whichever is larger: your AI plan's storage or your storage plan's. Traffic and backups always come from the storage plan.
| AI plan | Storage it includes |
|---|---|
| Free | 1 GB |
| Developer | 25 GB |
| Plus | 50 GB |
| Pro | 150 GB |
| Max | 400 GB |
| Ultra | 1 TB |
For example, on the Plus AI plan with the Free storage plan you can store 50 GB, with 10 GB of public traffic a month. Storage plans are billed separately from AI plans.
Changing plans
Upgrade, switch or cancel in Console › Storage plans. Plans renew monthly, and a new plan's limits apply as soon as the payment is confirmed.
Your files are never deleted when you change plans: if you store more than the new plan allows, they stay readable and new uploads are blocked until you're back under the limit.
Check your plan and usage
curl https://api.codebuckets.clatterlabs.xyz/v1/usage \
-H "Authorization: Bearer $CLATTER_API_KEY" -H "X-Clatter-Account: $CLATTER_ACCOUNT_ID"limits in the response has your plan, storage, this month's traffic and whether extra usage is allowed. See Get usage. The Console shows the same numbers on the Code Buckets page and in Storage plans.