> ## Documentation Index
> Fetch the complete documentation index at: https://docs.hivenet.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Manage objects in Hivenet Object Storage

> Upload files, organize object keys, download objects, and recover from partial upload or deletion failures.

Create an [access key](https://docs.hivenet.com/documentation/object-storage/access-keys.md) of your own if you do not already have an active one. Then open a bucket in **Object Storage** and use its **Objects** tab to work with files.

For self-service storage, uploads and deletions require a positive organization credit balance. At a zero or negative balance, these actions stop and the console's bucket view is locked. S3 clients can still list and download existing objects in **Read only** mode, but these actions are blocked in **Disabled** mode. The mode applied at zero credits depends on your organization's configuration. See [When credits run out](https://docs.hivenet.com/documentation/object-storage/usage-and-billing.md#when-credits-run-out).

An object key is the full name within the bucket, including any prefix. For example, `releases/1.4.2/app.zip` is one object key.

## Upload files

**1. Choose the destination**

Open the bucket and select **Upload**. In an empty bucket, use the upload area shown on the **Objects** tab.

Leave **Destination** empty to upload to the bucket root, or enter a prefix such as `releases/1.4.2/`. The prefix is added to each uploaded filename.

**2. Add files**

Select **Choose files** or drag files into the upload area. You can also drag files onto a populated object table.

Use **Upload more** to add files before starting.

**3. Review the files**

Check the destination, names, and sizes. Resolve invalid names and oversized files.

Review any **Replaces existing** or **Duplicate name** warnings.

**4. Start the upload**

Select the upload button for the selected files. Keep the tab open and follow the per-file progress.

**5. Check the result**

The console retries failed uploads automatically before showing an error. Check the final result and use **Retry failed files** if some files still failed.

While failed files remain in the dialog, you cannot add more files. Retry them or close the dialog before starting another upload.

Use **Retry all** only when you intend to upload the whole selection again. Repeating successful uploads can replace objects already stored at those keys.

Reloading the page stops all in-progress uploads. Files that finished uploading remain stored. After an interruption, check the object list and retry the files that are missing.

> [!WARNING]
>
> Uploading to an existing object key replaces the old object. If files in the same selection have the same destination key, the last write wins. Do not rely on the console to recover replaced data.

## Choose object names

For console uploads, use:

* Letters and numbers.
* `!`, `-`, `_`, `.`, `*`, `'`, `(`, and `)`.
* `/` between prefix segments.

The final object key must not start or end with `/` or contain a `..` path segment. The console allows up to 1,024 characters and rejects invalid names instead of silently changing them.

The [S3 object naming specification](https://docs.aws.amazon.com/AmazonS3/latest/userguide/object-keys.html) measures key length in UTF-8 bytes. Keep client-created keys within 1,024 bytes as well; non-ASCII characters can use more than one byte. Short ASCII names are the simplest choice across clients.

Objects created through an API may have names the console upload form would reject. Use the object's full, exact key when downloading, sharing, or deleting it.

## File size and large transfers

Hivenet Object Storage supports objects up to 5 TB through multipart uploads. A single `PutObject` request is limited to 5 GB.

The console handles multipart uploads automatically for larger files. Follow any file-size validation shown in the upload dialog and keep the tab open until the transfer finishes. The API limits above do not establish the console's maximum file size.

For large batches or unattended transfers, use [AWS CLI](https://docs.hivenet.com/documentation/object-storage/aws-cli.md), [boto3](https://docs.hivenet.com/documentation/object-storage/sdks.md), or [rclone](https://docs.hivenet.com/documentation/object-storage/rclone.md), which provide managed transfer functions.

An operation being implemented does not mean every client option is supported. Check [S3 compatibility](https://docs.hivenet.com/documentation/object-storage/s3-compatibility.md) before changing transfer settings.

## Download an object

1. Open the object's options menu.
2. Select **Download**.
3. Check your browser's download list.

Downloads do not show progress inside the console. Console downloads handle one object at a time. Multi-select supports deletion only.

To download many objects, use a client. The [AWS CLI](https://docs.hivenet.com/documentation/object-storage/aws-cli.md#download-many-objects) and [rclone](https://docs.hivenet.com/documentation/object-storage/rclone.md#download-a-bucket-or-prefix) guides show commands for a bucket or prefix.

## Delete objects

### Delete one object

Open the object's options menu, select **Delete**, review the confirmation, and confirm deletion.

### Delete several objects

1. Select **Select** and choose the objects.
2. Select **Delete**.
3. Check the selected keys and count in the confirmation.
4. Confirm deletion and read the result.

> [!WARNING]
>
> Object deletion is permanent. Check the selected objects and coordinate with other people who use them before confirming.

A partial result means some objects remain. Refresh the list and retry the remaining objects. A failed or interrupted operation is not proof that nothing was deleted.

A request for an object that has been deleted returns a not-found response. See [Troubleshooting](https://docs.hivenet.com/documentation/object-storage/troubleshooting.md) if a listed object cannot be opened.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.