Downloading files
Getting your files back, whole or chunk by chunk.
- How do I check a downloaded file is exactly what I uploaded?Downloads are decrypted and verified on our side. For your own check, compare SHA-256 hashes, per chunk or for the whole file.How-to
- How do I copy a file from one bucket to another?Download it from the first bucket and upload it to the second. There's no server-side copy.How-to
- How do I download a file from a bucket?GET /v1/buckets/{bucket_id}/objects/{object_id}/content streams the original file, decrypted, for files up to 1 GB.How-to
- How do I download a file from the Console?Open the bucket's files in the Console and download the one you need. Downloaded data counts 1 token per MiB.How-to
- How do I download a file larger than 1 GB?Download chunks 0 to chunk_count - 1 with GET …/chunks/{index} and join them in order. Each chunk carries its SHA-256.How-to
- How do I download an older version of my code?Download the zip object you uploaded at the time, or read the old tree by ref. Both stay available unless deleted.How-to
- How do I download everything in a bucket?List the bucket's objects and download each one. There's no single "download bucket" request.How-to
- How do I download one file from my code without the whole zip?GET /v1/buckets/{bucket_id}/files/{path}?download=1 returns that file's raw bytes from the code tree.How-to
- How many tokens do downloads use?1 token per request plus 1 per MiB downloaded. A 1 GB file costs about 1,025 tokens.FAQ
- I get 409 not_ready when downloading or reading an object. Why?The upload hasn't been completed yet. Finish (complete) the upload, or wait for it, then try again.Troubleshooting
- I get 413 use_chunks when downloading. What does it mean?The file is over 1 GB, so it can't be downloaded in one request. Download it chunk by chunk; error.chunk_count says how many.Troubleshooting
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.