What do all the Code Buckets error codes mean?
Errors are JSON with a code and a message; some add fields like missing_chunks.
| Status | Code | What to do |
|---|---|---|
| 400 | bad_request | A field is missing or invalid; the message says which |
| 400 | bad_chunk, bad_chunk_size | Use index 0 to chunk_count − 1 and exactly chunk_size bytes |
| 400 | checksum_mismatch | Send the chunk again |
| 400 | bad_ref, bad_path | ref must be 40 hex characters; path a file path in the tree |
| 401 | invalid_api_key, expired_api_key, missing_account_id, account_mismatch | Check the key and X-Clatter-Account |
| 402 | quota_exceeded | This month's tokens are used |
| 403 | insufficient_scope | Create a key with the needed permission |
| 404 | not_found | The id doesn't exist on your account |
| 409 | limit_reached | 100 projects, or 100 buckets per project |
| 409 | project_not_empty | Delete the project's buckets first |
| 409 | upload_incomplete | Send missing_chunks, then complete |
| 409 | upload_closed | The upload is already complete or aborted |
| 409 | not_ready | Wait for the upload to complete |
| 409 | backup_limit | Replace or delete your backup |
| 413 | bucket_full, too_large, use_chunks | Free space, shrink the body, or download in chunks |
| 429 | rate_limited | Wait Retry-After seconds |
| 502 | storage_error | Retry; chunk operations are safe to repeat |
| 503 | unavailable, storage_unavailable | Retry in a moment |
Learn more#
Related articles
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.