Skip to main content

Gets firmware artifact metadata

HEAD 
/iot/firmwares/:firmwareId/artifact

Returns the selected artifact metadata in response headers, with no response body.

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​

Selected release metadata. HEAD has no response body.

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