> For clean Markdown of any page, append .md to the page URL. For a complete documentation index, see https://ibee.ai/docs/llms.txt (full text of every page: https://ibee.ai/docs/llms-full.txt). For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://ibee.ai/docs/_mcp/server. # Objects > Upload, download, organize and delete files (objects) in IBEE Object Storage — in the portal (up to 300 MB per file) or with the AWS CLI and SDKs (up to 5 GiB per request, larger in parts). An **object** is a single file stored in a bucket, together with its details: size, content type and last-modified date. Each object is found by its **key**, the full name inside the bucket, such as `reports/2026/may.pdf`. This page shows how to upload, download, organize and delete objects in the portal and with S3 tools. ## When to use the portal or an S3 tool | You want to… | Use | Limit | | ---------------------------------------------- | -------------------------------------------------------------------------------------------- | ------------------------------------------------------------ | | Upload a few files, or a folder, by hand | The **portal** | 300 MB per file | | Upload big files, many files, or on a schedule | The **AWS CLI**, rclone or an SDK | 5 GiB per request; bigger files go up in parts automatically | | Let someone else upload or download one file | A [presigned URL](/docs/infrastructure/object-storage/objects/presigned-urls) | 1 second to 7 days | | Delete everything in a bucket | **Empty bucket** — see [Buckets](/docs/infrastructure/object-storage/buckets#empty-a-bucket) | Not for Object Lock or versioned buckets | ## How it works 1. An upload writes the whole file under its key. Uploading to a key that already exists **replaces** the file. 2. "Folders" are just the part of a key before a `/`. The portal shows them as folders so you can browse. 3. A download reads the whole file, or a byte range of it. ## Before you begin * A bucket. See [Create a bucket](/docs/infrastructure/object-storage/buckets). * For the portal: write access to the workspace (without it, **Upload** and **Create Folder** aren't shown). * For S3 tools: an [S3 credential](/docs/infrastructure/object-storage/api-tokens) with **Object Read & Write** (or **Admin Read & Write**) for the bucket, and the AWS CLI set up with region `auto` and path-style addressing as in [Using the S3 API](/docs/infrastructure/object-storage/s3-api). ## Upload in the portal ### Open the bucket In **Object Storage**, click the bucket's name. The **Objects** tab opens. ### Choose the files Click **Upload** to pick files, or open the arrow next to it and choose **Upload files** or **Upload folder**. You can also drag files onto the list. An empty bucket or folder shows **Upload Files** and **Upload Folder** buttons instead. ### Watch the upload An upload panel shows each file's progress; you can cancel a running upload there. Files over 300 MB are refused with *Files larger than 300 MB must be uploaded via the API.* ### Check the result The files appear in the list with their **Type**, **Storage Class**, **Size** and **Modified** date. ## Upload and download with the AWS CLI These commands use the `ibee` profile from [Using the S3 API](/docs/infrastructure/object-storage/s3-api). Replace `WORKSPACE-ID` with your endpoint's ID. ```bash # Upload one file to a key aws s3 cp report.pdf s3://my-bucket/reports/2026-05.pdf \ --endpoint-url https://WORKSPACE-ID.blob.ibeestorage.com --profile ibee # Upload a whole folder (only new or changed files) aws s3 sync ./build/ s3://my-bucket/site/ \ --endpoint-url https://WORKSPACE-ID.blob.ibeestorage.com --profile ibee # List one "folder" aws s3 ls s3://my-bucket/reports/ \ --endpoint-url https://WORKSPACE-ID.blob.ibeestorage.com --profile ibee # Download aws s3 cp s3://my-bucket/reports/2026-05.pdf ./2026-05.pdf \ --endpoint-url https://WORKSPACE-ID.blob.ibeestorage.com --profile ibee # Delete one file aws s3 rm s3://my-bucket/reports/2026-05.pdf \ --endpoint-url https://WORKSPACE-ID.blob.ibeestorage.com --profile ibee ``` The AWS CLI and SDKs switch to a **multipart upload** — sending a big file in parts, in parallel — for large files. You don't need to do anything; just remember the limits of 10,000 parts of up to 5 GiB each. To set the content type a browser sees (for example for website files), add `--content-type "text/html"` to `aws s3 cp`. ## Folders Create one in the portal with **Create Folder**: enter a **Folder Name** (placeholder `my-folder`) of letters, numbers, hyphens and underscores, and click **Create Folder**. It's created inside the folder you have open. Behind the scenes a folder is an empty object whose key ends in `/`. With S3 tools you don't need to create folders first: uploading to `photos/2026/beach.jpg` makes `photos/` and `photos/2026/` appear. ## Download, view and share * **Download**: click the download icon on the object's row. * **Details**: click the object's name to see its **Name**, **Size**, **Type**, **Modified** date and **Access** (**Public** or **Private**). Images show a **Preview**. * **Public link**: in a public bucket with a Public Access URL, the details show the object's **Public Development URL**, with a copy button. It's rate-limited and meant for testing; use a [custom domain](/docs/infrastructure/object-storage/buckets/custom-domains) for production. * **Private link**: create a [presigned URL](/docs/infrastructure/object-storage/objects/presigned-urls). ## Delete objects > **Warning** > > Deleted objects can't be recovered unless the bucket was created with Object Lock (which keeps versions). Check before you delete. * **One file**: click the delete icon on its row and confirm. * **Several files**: tick their boxes, click **Delete** in the toolbar (it shows how many are selected), and confirm. **Clear selection** cancels. * **Everything**: use [Empty bucket](/docs/infrastructure/object-storage/buckets#empty-a-bucket), or `aws s3 rm s3://my-bucket --recursive` for buckets with Object Lock or versioning. Objects under a legal hold or retention period can't be deleted; see [Object Locking](/docs/infrastructure/object-storage/objects/object-locking). ## Verify * The portal list shows the file with the expected **Size**. * `aws s3 ls s3://my-bucket/reports/ …` lists the key. * `aws s3api head-object --bucket my-bucket --key reports/2026-05.pdf …` prints its `ContentLength`, `ContentType` and `ETag` (a fingerprint of the content). ## Limits | | Value | | -------------------------------------- | ---------------------------------------------- | | Portal upload | 300 MB per file | | One S3 request (`PutObject`) | 5 GiB | | Multipart upload | Up to 10,000 parts, each up to 5 GiB | | Key length | 1,024 bytes of UTF-8 | | Folder name in the portal | Letters, numbers, hyphens, underscores; no `/` | | Keys per bulk delete (`DeleteObjects`) | 1,000 | ## Troubleshooting | You see | What it means | What to do | | ------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------ | | No **Upload** or **Create Folder** buttons | You're on the bucket list, or you don't have write access | Open a bucket; ask an admin for write access. | | *Files larger than 300 MB must be uploaded via the API.* | Portal limit | Use the AWS CLI, rclone or an SDK. | | *Folder name can only contain letters, numbers, hyphens, and underscores* | The folder name has spaces or symbols | Use a name like `invoices_2026`. | | *A folder with this name already exists* | Same name in this folder | Pick another name. | | *Cannot delete: object has legal hold* or *Cannot delete: object has retention lock* on the delete icon, or *Cannot delete "NAME". This object is protected.* | The object is under a legal hold or retention period | Remove the legal hold, or wait until the retention date. See [Object Locking](/docs/infrastructure/object-storage/objects/object-locking). | | *Downloads are unavailable while this organization is suspended.* | Your organization is suspended | Resolve the suspension under **Billing**, or contact support. | | A file you uploaded doesn't appear | The list hasn't refreshed, or it went to a different key or bucket | Refresh; check the full key, which is case-sensitive. | | `403` `AccessDenied` from the CLI on upload | The credential is read-only or limited to other buckets | Use an **Object Read & Write** credential for this bucket. | ## Related pages * [Presigned URLs](/docs/infrastructure/object-storage/objects/presigned-urls) * [Object Locking](/docs/infrastructure/object-storage/objects/object-locking) * [Buckets](/docs/infrastructure/object-storage/buckets) * [Using the S3 API](/docs/infrastructure/object-storage/s3-api) * [Mount a Bucket as a Filesystem](/docs/infrastructure/object-storage/mount-a-bucket-as-a-filesystem) ## Docs - [Object Locking](https://ibee.ai/docs/infrastructure/object-storage/objects/object-locking.md): Object Lock makes objects in an IBEE Object Storage bucket impossible to delete or overwrite until a retention date, or while a legal hold is on. Governance vs Compliance, how to turn it on at bucket creation, retention limits and fixes. - [Presigned URLs](https://ibee.ai/docs/infrastructure/object-storage/objects/presigned-urls.md): Share one private file, or let someone upload one, with a link that expires — no credentials needed. How long links last (1 second to 7 days), how to create them, and how to fix common errors.