Before you start
- An Iru API token with MCP turned on and permissions that cover the calls below (recipe 1).
- Blueprint Routing set up by a tenant admin. The API reads routing activity and the enrollment code. Routing rules change only in the web app.
Prompt for your agent
Pull recent Blueprint Routing activity from Iru with GET /api/v1/blueprint-routing/activity. For each Device Routed entry, show me the device, the ruleset it matched, that ruleset's position and its label. Then show me the current Manual Enrollment code status from GET /api/v1/blueprint-routing/. Don't change anything without my approval.
Steps
Read the routing activity
Results are paginated. Device Routed entries show the matched ruleset, its position and its label.
GET/api/v1/blueprint-routing/activitySource: Blueprint Routing
Check the enrollment code
This returns the enrollment code and active status that Blueprint Routing uses for Manual Enrollment and Android Work Profile enrollment.
GET/api/v1/blueprint-routing/Source: Iru API: Get Blueprint Routing
Change the code or its status after you approve
Send a body such as
{"enrollment_code":{"is_active":true,"code":"123456"}}to change the code or turn Manual Enrollment on or off.PATCH/api/v1/blueprint-routing/Approval requiredThe agent shows you the new code and status, then waits for your go.
Change routing rules in the web app
As a tenant admin, go to Enrollment > Blueprint Routing > Edit. Set if and else if blocks, set the Fallback under else, drag rules into order, then select Save.
Source: Blueprint Routing
Check it worked
- The Activity tab in Blueprint Routing shows the same Device Routed entries the agent reported.
Common pitfalls
- Rules run top to bottom, and the first match wins.
- Rules apply only during enrollment. Changing them doesn't move devices that are already enrolled.
- Routing rules can't use FileVault conditions.
FAQ
Can an agent change Blueprint Routing rules?
No. Rules change only in the web app, under Enrollment > Blueprint Routing > Edit. The API reads routing activity and manages the enrollment code and active status for Manual Enrollment and Android Work Profile.
How are routing rules evaluated?
Top to bottom, and the first match wins. Rules apply only at enrollment, so a rule change affects new enrollments only.
What does an activity entry show?
Device Routed entries name the ruleset, its position and its label. GET /api/v1/blueprint-routing/activity is paginated, so the agent pages through the results.