curl https://api.bota.dev/v1/firmware-releases/fw_3kQ9mZa7Rp2XvB4nT6yL8cW1 \
-H "Authorization: Bearer sk_live_..."
const response = await fetch(
'https://api.bota.dev/v1/firmware-releases/fw_3kQ9mZa7Rp2XvB4nT6yL8cW1',
{ headers: { 'Authorization': 'Bearer sk_live_...' } },
);
const release = await response.json();
import requests
response = requests.get(
'https://api.bota.dev/v1/firmware-releases/fw_3kQ9mZa7Rp2XvB4nT6yL8cW1',
headers={'Authorization': 'Bearer sk_live_...'},
)
release = response.json()
{
"id": "fw_3kQ9mZa7Rp2XvB4nT6yL8cW1",
"version": "1.0.7",
"changelog": "Fixes a battery drain during long Bluetooth sessions.",
"is_released": true,
"bin_sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
"bin_file_size_bytes": 1048576,
"ufw_sha256": "b94d27b9934d3e08a52e52d7da7dabfac484efe37a5380ee9088f7ace2efcde9",
"ufw_file_size_bytes": 1150000,
"created_at": "2026-08-14T09:12:00Z",
"updated_at": "2026-08-14T10:02:00Z"
}
{
"error": {
"code": "not_found",
"message": "FirmwareRelease not found"
}
}
Firmware
Get Firmware Release
Retrieve a single published firmware release
GET
/
firmware-releases
/
{id}
curl https://api.bota.dev/v1/firmware-releases/fw_3kQ9mZa7Rp2XvB4nT6yL8cW1 \
-H "Authorization: Bearer sk_live_..."
const response = await fetch(
'https://api.bota.dev/v1/firmware-releases/fw_3kQ9mZa7Rp2XvB4nT6yL8cW1',
{ headers: { 'Authorization': 'Bearer sk_live_...' } },
);
const release = await response.json();
import requests
response = requests.get(
'https://api.bota.dev/v1/firmware-releases/fw_3kQ9mZa7Rp2XvB4nT6yL8cW1',
headers={'Authorization': 'Bearer sk_live_...'},
)
release = response.json()
{
"id": "fw_3kQ9mZa7Rp2XvB4nT6yL8cW1",
"version": "1.0.7",
"changelog": "Fixes a battery drain during long Bluetooth sessions.",
"is_released": true,
"bin_sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
"bin_file_size_bytes": 1048576,
"ufw_sha256": "b94d27b9934d3e08a52e52d7da7dabfac484efe37a5380ee9088f7ace2efcde9",
"ufw_file_size_bytes": 1150000,
"created_at": "2026-08-14T09:12:00Z",
"updated_at": "2026-08-14T10:02:00Z"
}
{
"error": {
"code": "not_found",
"message": "FirmwareRelease not found"
}
}
Returns one published release. Use it to read the checksums and sizes before
downloading an image, or to confirm what a device was assigned.
An unpublished release answers
See List Firmware Releases for the field
reference.
404, the same as one that does not exist or
belongs to another organization.
Authentication
Requires an API key withdevices:read scope.
Path Parameters
string
required
The release identifier (e.g.,
fw_3kQ9mZa7Rp2XvB4nT6yL8cW1).curl https://api.bota.dev/v1/firmware-releases/fw_3kQ9mZa7Rp2XvB4nT6yL8cW1 \
-H "Authorization: Bearer sk_live_..."
const response = await fetch(
'https://api.bota.dev/v1/firmware-releases/fw_3kQ9mZa7Rp2XvB4nT6yL8cW1',
{ headers: { 'Authorization': 'Bearer sk_live_...' } },
);
const release = await response.json();
import requests
response = requests.get(
'https://api.bota.dev/v1/firmware-releases/fw_3kQ9mZa7Rp2XvB4nT6yL8cW1',
headers={'Authorization': 'Bearer sk_live_...'},
)
release = response.json()
{
"id": "fw_3kQ9mZa7Rp2XvB4nT6yL8cW1",
"version": "1.0.7",
"changelog": "Fixes a battery drain during long Bluetooth sessions.",
"is_released": true,
"bin_sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
"bin_file_size_bytes": 1048576,
"ufw_sha256": "b94d27b9934d3e08a52e52d7da7dabfac484efe37a5380ee9088f7ace2efcde9",
"ufw_file_size_bytes": 1150000,
"created_at": "2026-08-14T09:12:00Z",
"updated_at": "2026-08-14T10:02:00Z"
}
{
"error": {
"code": "not_found",
"message": "FirmwareRelease not found"
}
}
Was this page helpful?