List Devices | MediaKind Docs

{
  "supplemental": {
    "count": 1,
    "kind": "string",
    "operation": "string",
    "pagination": {
      "end": 1,
      "records": 1,
      "start": 1,
      "total": 1
    },
    "subscription": {
      "id": "string",
      "name": "string"
    }
  },
  "value": [
    {
      "metadata": {
        "displayName": "string",
        "labels": {}
      },
      "spec": {
        "released": "2025-03-24",
        "deprecatedOn": "2025-03-25",
        "displayName": "beam",
        "minimumVersion": "1.5",
        "minimumVersionHA": "1.7",
        "version": "1.0.0.0"
      },
      "status": {
        "downgradeCompatible": true,
        "upgradeCompatible": true
      },
      "kind": "string"
    }
  ],
  "@odata.nextLink": "string"
}

List software available to preload on the specified device.

RBAC Capability Required: fleet.devicesoftware.get

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

project_namestringRequired

namestringRequired

Query parameters

$orderbystringOptional

Specifies the key by which the result collection should be ordered.

$filterstringOptional

Restricts the set of items returned.

$topstringOptional

Specifies a non-negative integer n that limits the number of items returned from a collection. The service returns the number of available items up to but not greater than the specified value n.

$skiptokenstringOptional

Specifies a start offset to support paginated results. Use @odata.nextLink in the result object to enumerate the collection - it will be present only if there's more than one page of entities.

$label_keystringOptional

Filters the set to the specified label key. If multiple $label_keys are specified, matching items must have all labels.

$labelstringOptional

Filters the set to the specified label key/value pair. Supports equality, inequality, and inexact matching. If multiple values are provided for the same key, items matching either value will be returned.

Response

A list of software

supplementalobject

Supplemental info

valuelist of objects

A list of software versions available for this device.

@odata.nextLinkstringOptionalRead-only

@odata.nextLink URL if the page length and number of items match.

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

429

Too Many Requests Error

500

Internal Server Error