List available OS updates across fleet

GET

/v1/organizations/:organizationId/mdm/devices/available-updates

List available OS updates across fleet

Required Permission: mdm.global.device.list

Retrieves aggregated list of pending operating system updates available for managed devices with distribution counts, enabling coordinated update campaigns and security patch management.

Request

Add parameter in header authorization

Example: Authorization: Bearer <token>

organizationId string

required

Match pattern: ^(([a-fA-F0-9]{24})|([a-zA-Z0-9\\-]{3,}))$

os string

optional

Operating system platform filter or identifier for platform-specific queries and version statistics.

androidiosmacoswindows

Responses

200 Response application/json

status boolean optional

data object optional

items array [object] optional

{
    "status": true,
    "data": {
        "items": [
            {}
        ]
    }
}

401 Response application/json

status boolean optional

false

error object optional

code number optional

4001

message string optional

Unauthorized

{
    "status": false,
    "error": {
        "code": 4002,
        "message": "No auth token"
    }
}

404 Response application/json

status boolean optional

false

error object optional

code number optional

3001

message string optional

Entity not found

{
    "status": false,
    "error": {
        "code": 3001,
        "message": "Entity not found"
    }
}