# Blob Storage

### Overview

**Blob Storage** in Qubitro allows devices to store **binary data** such as images, audio, logs, or other large objects. 

It is a **fully managed, highly available, and scalable storage solution** designed to eliminate the need for third-party object storage.

<figure><img src="https://3109056034-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfQfo4zX1x0hfOimS9E2u%2Fuploads%2FMUnYiH5REybPPvK2yk5g%2FCleanShot%202025-03-03%20at%2021.03.28%402x.png?alt=media&#x26;token=520175a4-06b8-4bef-b237-3bdbfa3156b4" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
Blob Storage is an **Add-On** and must be activated from the **Organization Settings → Add-ons** menu. It is available **only on the Enterprise plan for Organizations**.
{% endhint %}

### Core Features

* [x] **Supports Various Data Types** – Store images, audio, video, and other binary objects.
* [x] **Retention Policy Matches Device Settings** – Blob data follows the **same retention period** as the device’s **Time Series Storage**.
* [x] **Multi-Access Support** – Retrieve and manage files via **APIs, dashboard widgets, and UI**.
* [x] **Scalable & Secure** – Designed for high availability and efficient object retrieval.

### Data Accessibility

Blob Storage **data** is available through:

#### **Device Detail Page → Storage Tab** (File management UI)

<figure><img src="https://3109056034-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfQfo4zX1x0hfOimS9E2u%2Fuploads%2FFrg3WbFGtrArNaOlFEwr%2FCleanShot%202025-03-03%20at%2021.10.13%402x.png?alt=media&#x26;token=b4982872-bb9d-4f90-a2a6-036b9d1e519e" alt=""><figcaption><p>Qubitro Blob Store View</p></figcaption></figure>

#### **Dashboard Widgets** (For viewing and managing stored objects)

<figure><img src="https://3109056034-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfQfo4zX1x0hfOimS9E2u%2Fuploads%2FgjOjwpSfTZF0QbYXslk7%2FCleanShot%202025-03-03%20at%2021.01.51%402x.png?alt=media&#x26;token=df7a81a9-f27b-4a6b-84a3-9421db3869c2" alt=""><figcaption><p>Qubitro Dashboard</p></figcaption></figure>

**APIs** (For retrieval)

{% hint style="info" %}
Accessing individual blob objects via the REST API is coming soon.
{% endhint %}

### Retention Period

Blob Storage retention **matches the device’s default retention period.**

### Data Size Limits

| Plan Type                           | Max File Size per Device |
| ----------------------------------- | ------------------------ |
| **Enterprise Plan (Organizations)** | 5 MB                     |

{% hint style="info" %}
Each device has **a maximum of 5MB** of Blob Storage. To store additional data, you must delete existing files or request a **higher storage allocation** based on your agreement.
{% endhint %}

### Uploading Blob Data

Qubitro allows you to upload blob data programmatically using the **Blob Upload API**.

#### Uploading a File

To upload a file to **Blob Storage**, use the API with an **Authorization Token** and attach the binary file to be uploaded.

```bash
curl --location 'https://webhook.qubitro.com/integrations/http/blob' \
--header 'Authorization: Basic YOUR_DEVICE_TOKEN' \
--form 'file=@"/path/to/your/file.png"'
```

#### Parameters:

* `Authorization` – Your **Device Token**, used for authentication.
* `file` – The **binary file** you want to upload.

{% hint style="success" %}
Qubitro automatically identifies the uploaded object type.
{% endhint %}

### Deleting Blob Data

Qubitro allows you to delete Blob Storage data **in bulk** or **individually through the UI**.

#### Bulk Deletion

You can delete **all stored blobs** for a device from the **Storage** tab by selecting **Delete all blob data** from the options menu. This action removes **all stored files** associated with the device.

<figure><img src="https://3109056034-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfQfo4zX1x0hfOimS9E2u%2Fuploads%2FKp9t9nB5C8Wo2Gwz8YXt%2FCleanShot%202025-03-03%20at%2021.06.46%402x.png?alt=media&#x26;token=5d1f3f80-2e0c-4e99-bcdc-0305c0c36d7e" alt=""><figcaption></figcaption></figure>

{% hint style="danger" %}
Data deletion is **permanent** and cannot be undone. Once deleted, the files **cannot be recovered**.
{% endhint %}

#### Deleting Individual Files

To delete a **specific file**, navigate to the **Storage Tab** and locate the file.&#x20;

Select the delete option by clicking the three dots next to the file to permanently remove it.

{% hint style="danger" %}
Data deletion is **permanent** and cannot be undone. Once deleted, the files **cannot be recovered**.
{% endhint %}