Before you start
- An Iru API token with MCP turned on and permissions that cover the calls below (recipe 1).
- The Library Item ID. The API reference documents no call that lists Library Items, so the agent can read it as
item_idfrom the Library Item list of a device that has the item (GET /api/v1/devices/{device_id}/library-items). The API reference doesn't say that this is the ID the status call takes, so the agent confirms it by checking that the status call returns devices for the item.
Prompt for your agent
Get the rollout status of the Library Item with ID [Library Item ID] using GET /api/v1/library/library-items/{library_item_id}/status. Count the devices in each status. Then list every device that is not yet in a finished state, with its name, Blueprint and status. Each call returns at most 300 records, so keep paging with limit and offset until you have read every record, and tell me the count you read. If you had to find the Library Item ID yourself, tell me where it came from.
Steps
Pull the item's status on every device
Each result carries the device in
computer, itsblueprint, thestatus,reported_at,log,last_audit_runandlast_audit_log. The response gives acount, and a request returns at most 300 records, so the agent pages withlimitandoffset.To check one device, pass its ID in the
computer_idparameter.GET/api/v1/library/library-items/{library_item_id}/statusCount devices by status
The device Library Item docs list values such as
PENDING,DOWNLOADING,INSTALLING,ERROR,PASS,successandfailed. Have the agent report the values it actually saw and how many devices have each.Compare with the Library
In the web app, open Library to see a preview of each Library Item's statuses and the number of devices in each status beneath its tile. Select the Status tab for the per-device view.
For Mac Auto Apps with phased rollout turned on, the Status tab also shows when each device becomes eligible for an updated version.
Common pitfalls
- A grey icon in the web app means the status is pending the next check-in, so a pending device may not have failed.
- A blue Remediated status is transient and turns green on the next Agent check-in.
- A call returns at most 300 records, so a partial read undercounts the fleet. Make the agent report how many records it read.
FAQ
Which API call shows a Library Item's rollout status?
GET /api/v1/library/library-items/{library_item_id}/status returns the status of the item on each device it is assigned to.
How do I check one device?
Pass the device ID in the computer_id parameter of the status call.
Where do I find the Library Item ID?
The API reference documents no call that lists Library Items. A device's Library Item list, GET /api/v1/devices/{device_id}/library-items, returns an item_id for each item.
Where do I see rollout status in the web app?
Open Library to see each item's statuses with device counts under its tile, then select the Status tab for the per-device view.