Before you start
- An Iru API token with MCP turned on and permissions that cover the calls below (recipe 1).
- Apple devices enrolled in Iru.
Prompt for your agent
Pull installed profile data for every Apple device in Iru from Prism with GET /api/v1/prism/installed_profiles. 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 rows by profile_display_name. For each profile, show its payload_identifier, its organization and the number of devices that have it. Then list the profiles where managed is false, since those weren't installed through Iru. Tell me which fields you used for that call.
Steps
Pull the Prism installed profiles category
The category covers all installed profiles on Apple devices, including profiles Iru Endpoint didn't install. Each row records whether the profile is managed, removable, signed and encrypted, and whether it has a removal passcode.
A hard limit of 300 device records applies to each request, so the agent pages with
limitandoffset.GET/api/v1/prism/installed_profilesSource: Prism
Group by profile
Each row is one profile on one device, so the same profile appears once per device. Have the agent group by
profile_display_name, count devices and showpayload_identifierandorganizationso you can tell profiles apart.Review the unmanaged profiles
Ask the agent to list the profiles where
managedis false, with the devices that have them. Those profiles came from somewhere other than Iru, and you can check each source.In the web app, open Devices, select the Prism tab, then open the Installed Profiles category.
Source: Prism
Common pitfalls
- Prism collects installed profiles every 24 hours, so a profile you just installed or removed can take that long to show.
- Each row carries a
profile_datalist that names the items inside the profile. - Prism data separates a value that is Empty from one that is Null, which means the attribute doesn't apply to the platform.
FAQ
Which API call lists installed profiles?
GET /api/v1/prism/installed_profiles returns installed profile attributes for Apple devices from Prism.
Does it include profiles Iru didn't install?
Yes. The category covers all installed profiles on Apple devices, including profiles not installed by Iru Endpoint.
How often does Prism collect profiles?
Every 24 hours, through MDM.
Which platforms does it cover?
iOS, iPadOS, tvOS, visionOS and macOS.