Skip to content
All recipes

Track one Library Item's rollout across your fleet

Pull the status of one Library Item on every device it is assigned to and count how many devices sit in each status.

Open in Claude Open in ChatGPT
Product
Endpoint Management
Platforms
All device types
Effect
Read-only
Agent access
Iru MCP or the Iru API

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_id from 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

  1. Pull the item's status on every device

    Each result carries the device in computer, its blueprint, the status, reported_at, log, last_audit_run and last_audit_log. The response gives a count, and a request returns at most 300 records, so the agent pages with limit and offset.

    To check one device, pass its ID in the computer_id parameter.

    GET/api/v1/library/library-items/{library_item_id}/status

    Source: Iru API: Get Library Item Statuses

  2. Count devices by status

    The device Library Item docs list values such as PENDING, DOWNLOADING, INSTALLING, ERROR, PASS, success and failed. Have the agent report the values it actually saw and how many devices have each.

    Source: Iru API: Get Device Library Items

  3. 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.

    Source: Library Item Status Activity Timeline

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.

Next steps

Sources

Stay up to date

Iru's bi-weekly collection of articles, videos, and research to keep IT & Security teams ahead of the curve.