Before you start
- An Iru API token with MCP turned on and permissions that cover the calls below (recipe 1).
- Devices enrolled in Iru.
Prompt for your agent
Pull device information for every device in Iru from Prism with GET /api/v1/prism/device_information. The call returns at most 300 records per request, so page through the results with limit and offset until you have them all. Group the devices by device__family and os_version, and show how many devices run each version. Tell me whether you used os_version or display_os_version, and flag any devices where the field is empty. I will tell you which version counts as current, so list the devices running anything older once I do.
Steps
Pull the Prism device information category
The Devices category holds general information about your enrolled devices. Each row names the device family in
device__familyand carriesos_version,os_buildanddisplay_os_version.A hard limit of 300 device records applies to each request, so the agent pages with
limitandoffset.GET/api/v1/prism/device_informationSource: Prism
Count devices by version
Have the agent group the rows by
device__familyandos_version. The docs don't define the difference betweenos_versionanddisplay_os_version, so ask the agent to say which one it used.List the devices behind the old versions
The response lists installed versions only, so tell the agent which version you consider current. It then lists each older device by name, serial number and assigned user.
In the web app, open Devices, select the Prism tab and stay on the Devices category.
Source: Prism
Common pitfalls
- Prism collects device data every 24 hours on Apple platforms and daily on Windows. Android reports when something changes on the device.
- The response doesn't say which OS version is current. You supply that version.
- A Null attribute doesn't apply to the device platform.
FAQ
Which API call returns OS versions?
GET /api/v1/prism/device_information returns device attributes, including os_version, os_build and display_os_version.
How many devices does one request return?
At most 300. The agent pages through larger fleets with limit and offset.
How current is the data?
Prism collects device data every 24 hours on Apple platforms and daily on Windows. Android reports when something changes on the device.
Does it cover Windows and Android?
Yes. The Devices category covers Apple, Windows and Android devices.