Before you start
- An Iru API token with MCP turned on and permissions that cover the calls below (recipe 1).
- Macs or Windows devices covered by Vulnerability Management.
Prompt for your agent
List vulnerabilities in Iru with GET /api/v1/vulnerability-management/vulnerabilities and show me the critical ones. Tell me which field you used for severity. For the CVE I pick, show its description, then list every affected device with GET /api/v1/vulnerability-management/vulnerabilities/{cve_id}/devices.
Steps
List vulnerabilities
Results come grouped by CVE. The docs list no severity filter for this call, so have the agent filter the response and name the severity field it used.
GET/api/v1/vulnerability-management/vulnerabilitiesSource: Iru API: List Vulnerabilities
Read the CVE
Pull the description of the CVE you picked.
GET/api/v1/vulnerability-management/vulnerabilities/{cve_id}List the affected devices
In the web app, search by CVE ID, open the CVE and select the Devices tab to filter by Detection date, Blueprint or Device.
GET/api/v1/vulnerability-management/vulnerabilities/{cve_id}/devicesSource: Vulnerability Management
Common pitfalls
- Devices scan every 15 minutes and matching runs hourly. Allow up to an hour for a new CVE to appear.
- Excluded devices don't count toward affected-device totals.
- A CVE shows as remediated only when every active, non-excluded device is patched.
- Only .app files in /Applications, /Library and /Users are scanned. System frameworks aren't.
FAQ
Which devices does Vulnerability Management cover?
Macs and Windows devices. Excluded devices aren't counted.
Can I filter vulnerabilities by severity in the API?
The List vulnerabilities call groups results by CVE and has no documented severity filter, so the agent filters the response and names the severity field it used.
How quickly does a new CVE show up?
Iru scans every 15 minutes and matches hourly, so allow up to an hour.
When does a CVE count as remediated?
Only when every active, non-excluded device is patched.