Skip to main content

Gets the eligible firmware artifact

GET 
/iot/firmwares/:firmwareId/artifact

Returns the selected artifact in the response body. Supports conditional and byte-range requests.

Fetches firmware for an app or other authenticated user without a thing or bootstrap record. Send the installed firmware version in the Version header to select the next eligible release, respecting mandatory intermediate upgrades and version constraints. Omit Version to select the firmware's active release. A supplied version with no eligible upgrade returns 204 No Content.

If-None-Match is a normal HTTP cache validator; it does not specify the installed version. Use the ETag returned by HEAD with If-Match on GET to require the same selected release.

Required Permission:

  • Resource: core:firmwares:{firmwareId}

  • Action: core:firmwares:download

Request​

Responses​

Firmware artifact or requested byte ranges.

Response Headers
    Content-Length

    Size of the firmware artifact in bytes.

    Content-Disposition
    Content-Digest

    Firmware checksum as sha256=.

    Version
    Min-Version

    Inclusive minimum installed version, when configured.

    Max-Version

    Exclusive maximum installed version, when configured.

    ETag

    Quoted selected-release version.

    Last-Modified
    Accept-Ranges
    Cache-Control
    Content-Range

    Byte positions and full file size for single-range 206 responses.