Before you start
- An Iru API token with MCP turned on and permissions that cover the calls below (recipe 1).
- The name of the Blueprint, Library Item or device that changed.
Prompt for your agent
Search the Iru audit log with GET /api/v1/audit/events?limit=500&sort_by=-occurred_at for changes to [Blueprint, Library Item or device name]. Show me who made each change, when, and what changed, newest first.
Steps
Pull recent audit events
The audit log covers Blueprint and Library Item changes, access to sensitive data such as FileVault keys, device lifecycle events, user directory events, and Vulnerability Management and EDR events.
GET/api/v1/audit/events?limit=500&sort_by=-occurred_atSource: Iru API: List audit events
Narrow to the change
Have the agent match events to the object you named and report the user, time and changed fields for each.
Source: Activity
Confirm it in the web app
Select the Activity icon at the top right. Filter by Date, User, Category and Activity type, then expand a row to see the changed fields or select Show JSON for the raw record.
Source: Activity
Common pitfalls
- The User filter leaves out directory-synced users.
- Admin invite, update and delete events live in the Identity activity log, not here.
FAQ
What does the audit log record?
Blueprint and Library Item changes, access to sensitive data such as FileVault keys, device lifecycle events, directory user events, and Vulnerability Management and EDR events.
Which call returns the newest events first?
GET /api/v1/audit/events?limit=500&sort_by=-occurred_at.
Where are admin invite, update and delete events?
Admin invite, update and delete events live in the Identity activity log, not in these audit events.
Can I filter by person in the web app?
Yes, with the User filter on the Activity page, but it leaves out directory-synced users.