Skip to content
All recipes

Check where Blueprint Routing sent new devices

Read Blueprint Routing activity to see which rule placed each new device, and manage the Manual Enrollment code through the API.

Open in Claude Open in ChatGPT
Product
Endpoint Management
Platforms
All enrolled devices
Effect
Read-only, one optional change
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).
  • 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

  1. Read the routing activity

    Results are paginated. Device Routed entries show the matched ruleset, its position and its label.

    GET/api/v1/blueprint-routing/activity

    Source: Blueprint Routing

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

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

    Source: Iru API: Update Blueprint Routing

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

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.