Skip to main content
PATCH
Update firmware

Authorizations

X-API-Key
string
header
required

Path Parameters

firmware_id
string<shortuuid>
required

Id of the firmware.

Required string length: 22
Pattern: ^[23456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz]{22}$

Body

application/json

Payload for PATCH /firmware/{firmware_id}. Only the keys present are applied.

version
string | null

Firmware version label.

Required string length: 1 - 50
Pattern: ^[^\x00]{1,50}$
url
string | null

Download URL. Must start with https://.

Required string length: 9 - 200
Pattern: ^[Hh][Tt][Tt][Pp][Ss]://[^\x00-\x20\x7f/?#][^\x00-\x20\x7f]{0,191}$
title
string | null

Display title.

Maximum string length: 255
Pattern: ^[^\x00]{0,255}$
release_date
string<date> | null

Release date (YYYY-MM-DD).

description
string | null

Short description.

Pattern: ^[^\x00]{0,}$
size_kb
integer | null

Download size in kilobytes.

Required range: 0 <= x <= 2147483647
minimum_hardware_version
string | null

Oldest hardware revision.

Maximum string length: 50
Pattern: ^[^\x00]{0,50}$
maximum_hardware_version
string | null

Newest hardware revision.

Maximum string length: 50
Pattern: ^[^\x00]{0,50}$
checksum_sha256
string | null

Lowercase hex SHA-256 of the download.

Maximum string length: 64
Pattern: ^([0-9a-f]{64})?$
release_notes
string | null

Release notes.

Pattern: ^[^\x00]{0,}$
is_latest
boolean | null

Whether this is the current release.

is_stable
boolean | null

Whether this is a stable release.

gtins
string<gtin>[] | null

Replace the set of products the firmware is shown on. Each must be a product the firmware's organization owns, else 404 and nothing changes. Omit to leave the products alone.

Required array length: 1 - 200 elements
Required string length: 8 - 14

Response

OK

A firmware release with the products it is shown on.

id
string<shortuuid>
required

URL-safe 22-character shortuuid encoding of the row's UUID primary key. Stable across the row's lifetime; suitable for sharing in URLs, log lines, and external SDK clients. Accepted on input as either the shortuuid form or the canonical UUID form (xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx).

Required string length: 22
Pattern: ^[23456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz]{22}$
version
string
required

Firmware version label.

title
string
required

Display title. Empty string when unset.

url
string
required

Download URL (https). Empty string when only an uploaded file exists.

file_url
string
required

URL of a file uploaded by staff through the admin. Empty string when there is none.

release_date
string<date> | null
required

Release date, or null when unknown.

description
string
required

Short description. Empty string when unset.

size_kb
integer
required

Download size in kilobytes. 0 when unknown.

minimum_hardware_version
string
required

Oldest hardware revision this runs on. Empty when unset.

maximum_hardware_version
string
required

Newest hardware revision this runs on. Empty when unset.

checksum_sha256
string
required

Lowercase hex SHA-256 of the download. Empty when unset.

release_notes
string
required

Release notes. Empty string when unset.

is_latest
boolean
required

Whether this is the current release.

is_stable
boolean
required

Whether this is a stable release rather than a beta.

products
FirmwareProductOut · object[]
required

The products this firmware is shown on, by GTIN.

created
string<date-time>
required

Server-side ISO 8601 timestamp of creation (UTC).

modified
string<date-time>
required

Server-side ISO 8601 timestamp of last modification (UTC).