Backblaze B2

App · 16 actions

Store and share files in Backblaze B2 cloud storage: upload, download, copy, hide and delete files, make temporary download links, manage buckets, and start a workflow when a new file arrives.

Actions

ActionWhat it does
Copy fileCopy a file to a new name, in the same bucket or another one, without downloading it.
Create bucketCreate a bucket.
Create download linkMake a temporary link anyone can use to download one file, even from a private bucket.
Delete bucketDelete an empty bucket.
Delete file versionPermanently delete one version of a file, or a hide marker to unhide the file.
Download fileDownload a file and save it to this workspace's files, so later steps can attach or read it.
Get account infoShow the Backblaze account the key belongs to and what the key may do: its capabilities and any bucket or folder it is limited to.
Get bucketGet one bucket: its type, settings and lifecycle rules.
Get file infoGet a file version's name, size, type, checksum and upload time.
Hide fileHide a file so it no longer appears in 'List files' or downloads by name.
List application keysList the account's application keys with their capabilities, restrictions and expiry.
List bucketsList the account's buckets, optionally only private or only public ones.
List file versionsList every version of every file in a bucket, newest first for each name, including hide markers and files that were overwritten.
List filesList the files in a bucket, or in one folder of it, in name order.
Update bucketChange who can read a bucket's files, its default Cache-Control, or when its files are hidden and deleted.
Upload fileUpload a file to a bucket from text or from a file.

Copy file

Copy a file to a new name, in the same bucket or another one, without downloading it. Up to 5 GB.

Inputs

File ID to copysource_file_idtextRequired
The id of the file version to copy, from 'List files'.
New file namenew_file_nametextRequired
The whole path for the copy, such as archive/june.pdf.
Copy into bucketdestination_bucket_idtext
Leave empty to copy within the same bucket.

Outputs

fileobject
The file
Example output
{
  "file": {
    "action": "copy",
    "bucket_id": "50fe1b8473d9c3e0a2150a10",
    "content_type": "application/pdf",
    "file_id": "4_z50fe1b8473d9c3e0a2150a10_f414f47665c80ca4c_d20261112_m070703_c005",
    "file_info": {},
    "file_name": "archive/june.pdf",
    "is_folder": false,
    "md5": "94930f8536f8bb0bd9b4e8934ac8632f",
    "sha1": "ad8fb1e445c2bcb58b4ef698b6c7ffe0e871b62f",
    "size": 20480,
    "uploaded_at": "2026-11-12T07:07:03.725Z",
    "uploaded_at_ms": 1794467223725
  }
}

Create bucket

Create a bucket. Names are unique across every Backblaze account, so a taken name is refused.

Inputs

Bucket namebucket_nametextRequired
6 to 50 letters, digits or hyphens, not starting with b2-. It cannot be changed later.
Who can read its filesbucket_typetext
Private buckets need a key or a download link to read. Public ones need a payment method on the Backblaze account. Defaults to private.One of: allPrivate (Private (default)), allPublic (Public).

Outputs

bucketobject
The bucket
Example output
{
  "bucket": {
    "account_id": "0eb4393025a0",
    "bucket_id": "50fe1b8473d9c3e0a2150a10",
    "bucket_info": {},
    "bucket_name": "lodol-reports-2026",
    "bucket_type": "allPrivate",
    "cors_rules": [],
    "encryption": "SSE-B2",
    "file_lock_enabled": false,
    "lifecycle_rules": [],
    "revision": 2
  }
}

Make a temporary link anyone can use to download one file, even from a private bucket. It stops working after the time you pick.

Inputs

Bucketbucket_idtextRequired
The bucket. Pick one, or give its name or id from an earlier step.
File namefile_nametextRequired
The file's whole path in the bucket, such as reports/june.pdf. 'List files' returns it.
Valid for (hours)valid_for_hoursnumber
1 to 168 hours (one week). The default is 24.From 1 to 168. Default: 24.

Outputs

bucket_idtext
The bucket
expires_attext
When the link stops working (ISO 8601)
file_nametext
The file's whole path
urltext
The link. Anyone who has it can download the file until it expires
valid_for_hoursnumber
How long the link works
Example output
{
  "bucket_id": "50fe1b8473d9c3e0a2150a10",
  "expires_at": "2026-11-13T07:07:03.000Z",
  "file_name": "reports/june.pdf",
  "url": "https://f005.backblazeb2.com/file/lodol-reports-2026/reports/june.pdf?Authorization=EXAMPLE",
  "valid_for_hours": 24
}

Delete bucket

Delete an empty bucket. Backblaze refuses if it still holds any file or version, so delete those first.

Inputs

Bucketbucket_idtextRequired
The bucket. Pick one, or give its name or id from an earlier step.

Outputs

bucketobject
The bucket, as it was
bucket_idtext
The bucket deleted
deletedtrue/false
Always true once deleted
Example output
{
  "bucket": {
    "account_id": "0eb4393025a0",
    "bucket_id": "50fe1b8473d9c3e0a2150a10",
    "bucket_info": {},
    "bucket_name": "lodol-reports-2026",
    "bucket_type": "allPrivate",
    "cors_rules": [],
    "encryption": "SSE-B2",
    "file_lock_enabled": false,
    "lifecycle_rules": [],
    "revision": 2
  },
  "bucket_id": "50fe1b8473d9c3e0a2150a10",
  "deleted": true
}

Delete file version

Permanently delete one version of a file, or a hide marker to unhide the file. This cannot be undone.

Inputs

File namefile_nametextRequired
The file's whole path in the bucket, such as reports/june.pdf. 'List files' returns it.
File IDfile_idtextRequired
The file version's id, from 'List files' or an earlier step.

Outputs

deletedtrue/false
Always true once deleted
file_idtext
The version deleted
file_nametext
The file's name
Example output
{
  "deleted": true,
  "file_id": "4_z50fe1b8473d9c3e0a2150a10_f414f47665c80ca4c_d20261112_m070703_c005",
  "file_name": "reports/june.pdf"
}

Download file

Download a file and save it to this workspace's files, so later steps can attach or read it. Up to 100 MB. Give a file ID to get one older version.

Inputs

Bucketbucket_idtextRequired
The bucket. Pick one, or give its name or id from an earlier step.
File namefile_nametextRequired
The file's whole path in the bucket, such as reports/june.pdf. 'List files' returns it.
File IDfile_idtext
Only to get one specific older version. Leave empty for the current file.

Outputs

content_typetext
The file's type
document_reftext
The saved file, usable as a file in later steps
file_idtext
The version's id in Backblaze
file_nametext
The whole path in the bucket
filenametext
The file's name without its folder
sha1text
The file's SHA-1 checksum
size_bytesnumber
Its size in bytes
urltext
A link to the saved copy
Example output
{
  "content_type": "application/pdf",
  "document_ref": "doc_0123456789abcdef0123456789abcdef",
  "file_id": "4_z50fe1b8473d9c3e0a2150a10_f414f47665c80ca4c_d20261112_m070703_c005",
  "file_name": "reports/june.pdf",
  "filename": "june.pdf",
  "sha1": "ad8fb1e445c2bcb58b4ef698b6c7ffe0e871b62f",
  "size_bytes": 20480,
  "url": "/actions/core/serve-document/doc_0123456789abcdef0123456789abcdef"
}

Get account info

Show the Backblaze account the key belongs to and what the key may do: its capabilities and any bucket or folder it is limited to.

Inputs

None.

Outputs

account_idtext
The Backblaze account id
api_urltext
The account's API address
capabilitieslist
What the key is allowed to do
download_urltext
The account's file download address
restricted_to_bucketslist
The buckets the key is limited to, empty if it can use all
restricted_to_prefixtext
The folder the key is limited to, empty if none
Example output
{
  "account_id": "0eb4393025a0",
  "api_url": "https://api005.backblazeb2.com",
  "capabilities": [
    "listBuckets",
    "listFiles",
    "readFiles",
    "writeFiles"
  ],
  "download_url": "https://f005.backblazeb2.com",
  "restricted_to_buckets": [],
  "restricted_to_prefix": ""
}

Get bucket

Get one bucket: its type, settings and lifecycle rules.

Inputs

Bucketbucket_idtextRequired
The bucket. Pick one, or give its name or id from an earlier step.

Outputs

bucketobject
The bucket
Example output
{
  "bucket": {
    "account_id": "0eb4393025a0",
    "bucket_id": "50fe1b8473d9c3e0a2150a10",
    "bucket_info": {},
    "bucket_name": "lodol-reports-2026",
    "bucket_type": "allPrivate",
    "cors_rules": [],
    "encryption": "SSE-B2",
    "file_lock_enabled": false,
    "lifecycle_rules": [],
    "revision": 2
  }
}

Get file info

Get a file version's name, size, type, checksum and upload time.

Inputs

File IDfile_idtextRequired
The file version's id, from 'List files' or an earlier step.

Outputs

fileobject
The file
Example output
{
  "file": {
    "action": "upload",
    "bucket_id": "50fe1b8473d9c3e0a2150a10",
    "content_type": "application/pdf",
    "file_id": "4_z50fe1b8473d9c3e0a2150a10_f414f47665c80ca4c_d20261112_m070703_c005",
    "file_info": {},
    "file_name": "reports/june.pdf",
    "is_folder": false,
    "md5": "94930f8536f8bb0bd9b4e8934ac8632f",
    "sha1": "ad8fb1e445c2bcb58b4ef698b6c7ffe0e871b62f",
    "size": 20480,
    "uploaded_at": "2026-11-12T07:07:03.725Z",
    "uploaded_at_ms": 1794467223725
  }
}

Hide file

Hide a file so it no longer appears in 'List files' or downloads by name. Its data stays, and deleting the hide marker with 'Delete file version' brings it back.

Inputs

Bucketbucket_idtextRequired
The bucket. Pick one, or give its name or id from an earlier step.
File namefile_nametextRequired
The file's whole path in the bucket, such as reports/june.pdf. 'List files' returns it.

Outputs

fileobject
The file
Example output
{
  "file": {
    "action": "hide",
    "bucket_id": "50fe1b8473d9c3e0a2150a10",
    "content_type": "application/x-bz-hide-marker",
    "file_id": "4_z50fe1b8473d9c3e0a2150a10_f414f47665c80ca4c_d20261112_m070703_c005",
    "file_info": {},
    "file_name": "reports/june.pdf",
    "is_folder": false,
    "md5": "94930f8536f8bb0bd9b4e8934ac8632f",
    "sha1": "ad8fb1e445c2bcb58b4ef698b6c7ffe0e871b62f",
    "size": 0,
    "uploaded_at": "2026-11-12T07:07:03.725Z",
    "uploaded_at_ms": 1794467223725
  }
}

List application keys

List the account's application keys with their capabilities, restrictions and expiry. Never shows a key's secret.

Inputs

How manymax_key_countnumber
How many keys to return, 1 to 1000. The default is 100.From 1 to 1000.
Start at key IDstart_key_idtext
The 'next_key_id' from an earlier page, to get the page after it.

Outputs

countnumber
How many keys are in this page
keyslist
The account's application keys
next_key_idtext
Pass this as 'Start at key ID' for the next page; empty on the last page
Example output
{
  "count": 1,
  "keys": [
    {
      "bucket_ids": [],
      "capabilities": [
        "listBuckets",
        "listFiles",
        "readFiles",
        "writeFiles"
      ],
      "expires_at": null,
      "key_id": "0050eb4393025a00000000001",
      "key_name": "Lodol",
      "name_prefix": null
    }
  ],
  "next_key_id": ""
}

List buckets

List the account's buckets, optionally only private or only public ones.

Inputs

Typebucket_typetext
Which buckets to list. Defaults to every bucket.One of: all (Every bucket (default)), allPrivate (Private buckets), allPublic (Public buckets).

Outputs

bucketslist
The buckets
countnumber
How many buckets
Example output
{
  "buckets": [
    {
      "account_id": "0eb4393025a0",
      "bucket_id": "50fe1b8473d9c3e0a2150a10",
      "bucket_info": {},
      "bucket_name": "lodol-reports-2026",
      "bucket_type": "allPrivate",
      "cors_rules": [],
      "encryption": "SSE-B2",
      "file_lock_enabled": false,
      "lifecycle_rules": [],
      "revision": 2
    }
  ],
  "count": 1
}

List file versions

List every version of every file in a bucket, newest first for each name, including hide markers and files that were overwritten.

Inputs

Bucketbucket_idtextRequired
The bucket. Pick one, or give its name or id from an earlier step.
Folderprefixtext
Only files whose name starts with this, such as reports/. Leave empty for the whole bucket.
How manymax_file_countnumber
How many files to return, 1 to 1000. The default is 100.From 1 to 1000.
Start at file namestart_file_nametext
The 'next_file_name' from an earlier page, to get the page after it. Leave empty for the first page.
Start at file IDstart_file_idtext
The 'next_file_id' from an earlier page. Use it together with 'Start at file name'.

Outputs

countnumber
How many files are in this page
fileslist
The file versions in this page
next_file_idtext
Pass this as 'Start at file ID' with the name for the next page; empty on the last page
next_file_nametext
Pass this as 'Start at file name' for the next page; empty on the last page
Example output
{
  "count": 1,
  "files": [
    {
      "action": "upload",
      "bucket_id": "50fe1b8473d9c3e0a2150a10",
      "content_type": "application/pdf",
      "file_id": "4_z50fe1b8473d9c3e0a2150a10_f414f47665c80ca4c_d20261112_m070703_c005",
      "file_info": {},
      "file_name": "reports/june.pdf",
      "is_folder": false,
      "md5": "94930f8536f8bb0bd9b4e8934ac8632f",
      "sha1": "ad8fb1e445c2bcb58b4ef698b6c7ffe0e871b62f",
      "size": 20480,
      "uploaded_at": "2026-11-12T07:07:03.725Z",
      "uploaded_at_ms": 1794467223725
    }
  ],
  "next_file_id": "",
  "next_file_name": ""
}

List files

List the files in a bucket, or in one folder of it, in name order. Hidden files are not listed.

Inputs

Bucketbucket_idtextRequired
The bucket. Pick one, or give its name or id from an earlier step.
Folderprefixtext
Only files whose name starts with this, such as reports/. Leave empty for the whole bucket.
Show foldersfolder_viewtrue/false
On: show each folder inside the path as one entry instead of listing every file in it.
How manymax_file_countnumber
How many files to return, 1 to 1000. The default is 100.From 1 to 1000.
Start at file namestart_file_nametext
The 'next_file_name' from an earlier page, to get the page after it. Leave empty for the first page.

Outputs

countnumber
How many files are in this page
fileslist
The files in this page
next_file_nametext
Pass this as 'Start at file name' for the next page; empty on the last page
Example output
{
  "count": 1,
  "files": [
    {
      "action": "upload",
      "bucket_id": "50fe1b8473d9c3e0a2150a10",
      "content_type": "application/pdf",
      "file_id": "4_z50fe1b8473d9c3e0a2150a10_f414f47665c80ca4c_d20261112_m070703_c005",
      "file_info": {},
      "file_name": "reports/june.pdf",
      "is_folder": false,
      "md5": "94930f8536f8bb0bd9b4e8934ac8632f",
      "sha1": "ad8fb1e445c2bcb58b4ef698b6c7ffe0e871b62f",
      "size": 20480,
      "uploaded_at": "2026-11-12T07:07:03.725Z",
      "uploaded_at_ms": 1794467223725
    }
  ],
  "next_file_name": ""
}

Update bucket

Change who can read a bucket's files, its default Cache-Control, or when its files are hidden and deleted. Only what you fill in changes.

Inputs

Bucketbucket_idtextRequired
The bucket. Pick one, or give its name or id from an earlier step.
Who can read its filesbucket_typetext
Leave empty to keep it as it is.One of: allPrivate (Private (default)), allPublic (Public).
Default Cache-Controldefault_cache_controltext
Sent with downloads of the bucket's files, such as max-age=3600. Leave empty to keep it.
Hide files after (days)hide_after_daysnumber
Hide every file this many days after it was uploaded. Leave empty to keep the current rule.From 1 to 3650.
Delete hidden files after (days)delete_hidden_after_daysnumber
Permanently delete a file this many days after it was hidden. Leave empty to keep the current rule.From 1 to 3650.

Outputs

bucketobject
The bucket
Example output
{
  "bucket": {
    "account_id": "0eb4393025a0",
    "bucket_id": "50fe1b8473d9c3e0a2150a10",
    "bucket_info": {
      "Cache-Control": "max-age=3600"
    },
    "bucket_name": "lodol-reports-2026",
    "bucket_type": "allPrivate",
    "cors_rules": [],
    "encryption": "SSE-B2",
    "file_lock_enabled": false,
    "lifecycle_rules": [],
    "revision": 3
  }
}

Upload file

Upload a file to a bucket from text or from a file. A file already at that name is kept as an older version. Up to 100 MB.

Inputs

Bucketbucket_idtextRequired
The bucket. Pick one, or give its name or id from an earlier step.
File namefile_nametextRequired
The whole path to save it as, such as reports/june.pdf. Folders need no setup.
Text contentcontenttext
Text to save as the file. Use this or 'File', not both.
Filefiletext
The file to save: upload one, or pick one an earlier step made. Use this or 'Text content', not both.
Content typecontent_typetext
A type such as application/pdf. Empty: Backblaze works it out from the file name.

Outputs

fileobject
The file
Example output
{
  "file": {
    "action": "upload",
    "bucket_id": "50fe1b8473d9c3e0a2150a10",
    "content_type": "application/pdf",
    "file_id": "4_z50fe1b8473d9c3e0a2150a10_f414f47665c80ca4c_d20261112_m070703_c005",
    "file_info": {},
    "file_name": "reports/june.pdf",
    "is_folder": false,
    "md5": "94930f8536f8bb0bd9b4e8934ac8632f",
    "sha1": "ad8fb1e445c2bcb58b4ef698b6c7ffe0e871b62f",
    "size": 20480,
    "uploaded_at": "2026-11-12T07:07:03.725Z",
    "uploaded_at_ms": 1794467223725
  }
}

On this page