List firmware update

The following sample request obtains the details of the latest firmware update of a device.

Request

GET /ws/v1/firmware_updates/inventory/00000000-00000000-0040FFFF-FF654321

Response

{
    "id": 1,
    "device_id": "00000000-00000000-0040FFFF-FF654321",
    "customer_id": 1977,
    "start_time": "2021-02-22T09:58:40.070Z",
    "end_time": "2021-02-22T10:02:54.020Z",
    "status": "failed",
    "version": "17.4.1.7",
    "error_message": "Device Not Connected"
}

The response contains the following properties:

  • id - Unique identifier of the firmware update.
  • device_id - Unique identifier of the device associated to the firmware update.
  • custormer_id - Unique customer ID for the Remote Manager customer.
  • start_time - Time at which the firmware update started.
  • end_time - Time at which the firmware update ended.
  • status - The status of the firmware update process. One of:
    • active
    • waiting
    • successful
    • failed
    • canceled
    • starting
  • version - Firmware version being applied in the firmware update process.
  • file - File used to update the device in case a file was used instead of a version.
  • error_message - If the status of the firmware update is failed or canceled, this field contains information about the error.