Skip to main content

Retrieve Latest Release for a Device

GET 

/api/v0/releases/latest

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

Query ParameterTypeDescription
hardware_version
Required
StringHardware Version of the Device
software_type
Required
StringSoftware Type being looked up for the Device
current_version
Suggested
StringThe Software Version that the Device is currently running (used for hopping through versions)
device_serial
Required
StringThe 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 Requesthardware_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.

Request

Responses

Response Headers