# 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 %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.qubitro.com/add-ons/blob-storage.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.