Releases

Retrieve Latest Release for a Device

For a given Device (Device Unique Identifier and Hardware Version), return the latest Release that should be installed.

Query ParameterTypeDescription
hardware_version <br />RequiredStringHardware Version of the Device
software_type <br />RequiredStringSoftware Type being looked up for the Device
current_version <br />SuggestedStringThe Software Version that the Device is currently running (used for hopping through versions)
device_serial <br />RequiredStringThe Device serial to identify a particular device (used for determining the Cohort)

NOTE: This endpoint requires that the sender use a custom HTTP header defining the Memfault Project Client Key.

Memfault-Project-Key: 87c2ca9d3ec148ac82034fc2724ff614

Note: More details about version nomenclature can be found here.


Return Value

  • 200 Ok — Returns a Release Schema if an update is available. The artifact URL(s) contained within will be direct links to OTA payloads served from Memfault's CDN. These URLs have an expiry of 6 hours.
  • 204 No Content — No new release available for the given device.
  • 400 Bad Request — hardware_version or software_type don't exist, or device_serial is missing.
  • 403 Unauthorized — Project Key is missing or invalid.
  • 503 Service Unavailable — Retry after the interval specified in the Retry-After response header.
get/api/v0/releases/latest

Request

Headers

Memfault-Project-Keystring required
Example:87c2ca9d3ec148ac82034fc2724ff614

Changes

No recorded changes to this operation across all 2 revisions of this API.