> For the complete documentation index, see [llms.txt](https://docs.stackai.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.stackai.com/integrations/catalog/backblaze-b2.md).

# Backblaze B2

Upload, download, list, and delete Backblaze B2 file versions.

### Connectors

Choose the connector that matches your authentication method. The options below use the names shown in StackAI.

| Connector    | Authentication  |
| ------------ | --------------- |
| Backblaze B2 | Application Key |

#### Backblaze B2

Connect to Backblaze B2 cloud storage with a least-privilege application key.

**Set up in Backblaze B2**

1. Prepare the Backblaze B2 account or service that the workflow will access. Grant access to the required resources and operations.
2. **Application Key ID:** Create a least-privilege Backblaze B2 application key and copy its key ID.
3. **Application Key:** Copy the application key secret when you create the least-privilege key.

**Set up in StackAI**

1. Open **Settings → Connections**, add a connection, and select **Backblaze B2**.
2. Enter the credentials and connection details in the fields below.
3. Save the connection and check its connection status. Select this saved connection when configuring an action or feature that uses it.

**Connection fields**

| StackAI field      | Required | What to enter                                                                                                                                                         |
| ------------------ | -------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Application Key ID | Yes      | Create a least-privilege Backblaze B2 application key and copy its key ID. [Provider instructions](https://www.backblaze.com/docs/en/cloud-storage-application-keys). |
| Application Key    | Yes      | Copy the application key secret when you create the least-privilege key. [Provider instructions](https://www.backblaze.com/docs/en/cloud-storage-application-keys).   |

#### Verify the connection

Check that the connection is healthy. Then run a read operation against a resource the connected account can access. A successful connection check confirms authentication; it does not guarantee permission for every action.

If access is denied, check the credential or OAuth permissions, the selected account or environment, and access to the specific resource. Update expired credentials or reconnect after permissions change.

### Use an action

1. Add the required **Backblaze B2** action to the workflow.
2. Select a connection when the action requests one.
3. Complete the required fields. Use the reference picker when a value comes from another workflow step.
4. Run the workflow and inspect the action’s output. Check the result before using it in a later step.

### Actions

#### Upload File

Upload one file from a URL to a Backblaze B2 bucket.

**Required permissions:** `writeFiles`.

**Inputs**

| Field        | Type            | Required | Description                                                                   |
| ------------ | --------------- | -------- | ----------------------------------------------------------------------------- |
| Bucket       | select (string) | Yes      | Bucket that will receive the file. Options load from the selected connection. |
| Source URL   | string          | Yes      | HTTPS URL of the file to upload.                                              |
| File Name    | string          | Yes      | Name and optional path to use in the bucket.                                  |
| Content Type | string          | No       | MIME type stored with the file. Default: b2/x-auto.                           |

**Outputs**

| Field          | Type    | Description                               |
| -------------- | ------- | ----------------------------------------- |
| File ID        | string  | Identifier of the created file version.   |
| File Name      | string  | Name stored for the created file version. |
| Content Length | integer | Size of the uploaded file in bytes.       |

#### Download File by Name

Download the current version of one Backblaze B2 file by bucket and name.

**Required permissions:** `readFiles`.

**Inputs**

| Field       | Type            | Required | Description                                                            |
| ----------- | --------------- | -------- | ---------------------------------------------------------------------- |
| Bucket      | select (string) | Yes      | Bucket containing the file. Options load from the selected connection. |
| File Name   | string          | Yes      | Exact name and path of the file to download.                           |
| Range Start | integer         | No       | First byte to download for a partial response.                         |
| Range End   | integer         | No       | Last byte to download for a partial response.                          |

**Outputs**

| Field | Type         | Description      |
| ----- | ------------ | ---------------- |
| File  | binary\_file | Downloaded file. |

#### List File Names

List current visible files and folders in a Backblaze B2 bucket.

**Required permissions:** `listFiles`.

**Inputs**

| Field            | Type            | Required | Description                                                                            |
| ---------------- | --------------- | -------- | -------------------------------------------------------------------------------------- |
| Bucket           | select (string) | Yes      | Bucket whose current files will be listed. Options load from the selected connection.  |
| Name Prefix      | string          | No       | Only include names that begin with this text.                                          |
| Folder Delimiter | select (string) | No       | Optionally group path-like names into folders. Available values: Group by folders (/). |
| Cursor           | string          | No       | Continue a previous truncated listing.                                                 |
| Result Limit     | integer         | No       | Maximum files and folders to return. Minimum: 1. Maximum: 10000. Default: 1000.        |

**Outputs**

| Field             | Type          | Description                                           |
| ----------------- | ------------- | ----------------------------------------------------- |
| Files and Folders | object\_array | Current files and folder entries in the bucket.       |
| Next Cursor       | string        | Cursor for the next portion when more results remain. |

#### Get Upload URL

Get a temporary Backblaze B2 upload target for one bucket.

**Required permissions:** `writeFiles`.

**Inputs**

| Field  | Type            | Required | Description                                                                                      |
| ------ | --------------- | -------- | ------------------------------------------------------------------------------------------------ |
| Bucket | select (string) | Yes      | Bucket that the temporary upload target may write to. Options load from the selected connection. |

**Outputs**

| Field               | Type   | Description                                                  |
| ------------------- | ------ | ------------------------------------------------------------ |
| Upload URL          | string | Temporary URL for uploading one file to the selected bucket. |
| Authorization Token | secret | Temporary authorization token for the upload URL.            |

#### Delete File Version

Permanently delete one exact Backblaze B2 file version.

**Required permissions:** `deleteFiles`.

**Inputs**

| Field                       | Type    | Required | Description                                                                   |
| --------------------------- | ------- | -------- | ----------------------------------------------------------------------------- |
| File Name                   | string  | Yes      | Exact name of the file version to delete.                                     |
| File ID                     | string  | Yes      | Unique ID of the exact file version to delete.                                |
| Bypass Governance Retention | boolean | No       | Allow deletion through governance-mode Object Lock retention. Default: false. |

**Outputs**

| Field     | Type   | Description                       |
| --------- | ------ | --------------------------------- |
| File ID   | string | ID of the deleted file version.   |
| File Name | string | Name of the deleted file version. |

### Important behavior

Actions that create, update, send, or delete data can change the connected service. Review their inputs before running them. A retry can repeat an operation; consider this when configuring retries for actions that change data.

The catalog lists the fields and capabilities available in the supplied provider definition. Availability can also depend on your deployment and organization’s Feature Access settings.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

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

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.stackai.com/integrations/catalog/backblaze-b2.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
