Get all releases with their status

GET 
/api/v2/device/releases

Retrieves a list of all software releases on the root device with their current status. Only includes components in delivery state or beyond (excludes offered/pushed components). Returns delivery progress, deployment status, and installation state for each release.

Request

Responses

200

application/json

Schema

Schema

• Array [

catalogId stringrequired
latest booleannullable
metadata nullable
name stringrequired
releaseAt date-timenullable
releaseNotes stringnullable
size int64required
version stringrequired
deliveryState DeliveryStatenullable

Possible values: [prepare, download, validation, done]

downloadDuration int32nullable

Download duration in seconds (for delivery state)

errMsg stringnullable

Error message if any error occurred

eta int64nullable

Estimated time remaining in seconds

progress floatnullable

Progress percentage (0-100)

state DeviceReleaseStaterequired

Possible values: [delivery, downloaded, deleted, deploy, installed, uninstalled]

Represents the state of a release on the device Subset of DeviceComponentState containing only Delivery state and greater

status

object

nullable

Status enum that can be either a delivery status or a deployment status

oneOf

DeliveryStatusEnum

string

DeploymentStatus

string

• ]

Example (from schema)

[
  {
    "catalogId": "string",
    "latest": true,
    "name": "string",
    "releaseAt": "2026-03-12T11:20:53.458Z",
    "releaseNotes": "string",
    "size": 0,
    "version": "string",
    "deliveryState": "prepare",
    "downloadDuration": 0,
    "errMsg": "string",
    "eta": 0,
    "progress": 0,
    "state": "delivery",
    "status": "Start"
  }
]

500

application/json

Schema

Schema

message stringrequired
name stringrequired
statusCode int32required

Example (from schema)

{
  "message": "string",
  "name": "string",
  "statusCode": 0
}

Loading...