The Iru Endpoint API is a robust tool designed to help you manage and secure Apple devices within your organization. It allows you to automate tasks, integrate with other services, and enhance Iru Endpoint’s capabilities beyond the user interface.
Generate an API Token
For each specific use case, it’s best to create a unique API Token. To easily identify them, consider assigning clear and descriptive names within the Iru Endpoint Web App.
Iru Endpoint uses tenant-level bearer tokens to control access to the API. To generate one:
Open Access
Click your name at the bottom of the left navigation, then select Access.
Create new API token
Click the Add API Token button to create a new API key. Configure token details
Provide a Name and a Description for your API token.
Copy and store token
Iru Endpoint will display a modal with the API token. Click the visibility symbol to expose it or use the Copy Token button to copy the API token to your clipboard, storing it in a safe place. Note:You will not be able to see the token details again.
Configure permissions
Click Configure to manage the API permissions for this specific token or Skip to change them later. Save configuration
After making your modifications, click Save.
View API URL
Once you create your first token, you will see your tenant-specific API URL.
Inspect, Modify, or Revoke an API Token
If you remove an admin user from the Iru Endpoint Web App after they’ve created an API Token, the API Token will remain active. You’ll need to manually revoke the token if you want to prevent further access.
After you create an API token for your tenant, you can modify its name and permissions or revoke it to prevent further access.
Inspect or Modify a Token
Access token options
Click the vertical ellipsis next to the token.
View token details
Click View to display information about the token, including the permissions associated with the token. From this page, you can use the following options.
Edit permissions
Click the Permissions tab to edit the permissions associated with the token. View activity
Click the Activity tab to view the activity of the API token, including:
- Token created
- Token name changed
- Token permissions edited
Revoke a Token
Edit token name
In the lower-right corner, click Edit to edit the name of the token.
Revoke token
Click Revoke to invalidate the API token and prevent its further use. If you revoke a token, you will no longer see it in the list of API tokens for your tenant.