Before you start
- An Iru API token with all ADE-related permissions (recipe 1).
- Access to Apple Business or Apple School Manager to download each new token.
- If a token expires, Iru can no longer sync devices from Apple Business or Apple School Manager. You can renew at any time.
Prompt for your agent
List my ADE integrations in Iru with GET /api/v1/integrations/apple/ade. For each one, show me its server_name, days_left and whether it uses Blueprint Routing, sorted by days_left. Then stop. When I give you a downloaded .p7m token file and the token it belongs to, show me the renew request and wait for my approval before you send it. Afterward, check that days_left is 364.
Steps
List your ADE tokens
Have the agent list each token with its
server_nameanddays_left. With Blueprint Routing on,use_blueprint_routingis true andblueprint_idis null.GET/api/v1/integrations/apple/adeSource: Iru API: List ADE integrations
Download the new token from Apple
In Apple Business or Apple School Manager, open the Devices tab, then Management Services. Select the service that matches
server_name, open the ellipsis (…) menu and select Download Token to get a .p7m file.Source: Renew multiple ADE tokens
Renew the token after you approve
Send the default
blueprint_id,phone,emailand the tokenfile. With Blueprint Routing, senduse_blueprint_routingas true andblueprint_idas null.The web app renews only the token shown on its page (Account Menu > Integrations > Apple > Renew Token). Renew any other token through the API.
POST/api/v1/integrations/apple/ade/{ade_token_id}/renewApproval requiredThe agent shows you which token and which .p7m file it's about to send, then waits for your go.
Source: Renew multiple ADE tokens
Confirm the renewal
Read the token back and check
days_left.GET/api/v1/integrations/apple/ade/{ade_token_id}Source: Renew multiple ADE tokens
Check it worked
days_leftis 364 after a successful renewal.
Common pitfalls
- Don't disconnect an existing token to renew it.
- Keep track of each downloaded .p7m file and match it to the right token ID.
- Test on one token before you renew several at once.
FAQ
How do I find ADE tokens that are close to expiring?
GET /api/v1/integrations/apple/ade lists each ADE integration with its server_name and days_left.
What does a renewal request need?
The default blueprint_id, phone, email and the .p7m token file from Apple Business or Apple School Manager. With Blueprint Routing, send use_blueprint_routing as true and blueprint_id as null.
What happens if a token expires?
Device sync from Apple Business or Apple School Manager stops. You can renew at any time, and you don't need to disconnect the integration to renew it.
How do I confirm the renewal worked?
days_left reads 364 after a successful renewal.