List managed devices in Miradore with optional filters. Returns a compact summary per device (id, name, model, serial, platform, OS version, online status, last check-in, user, tags, enrollment type). Retired devices are excluded unless include_retired or status is given. Use get_device for full details on one device.

Get one device by its Miradore device ID, with optional detail sections: apps (installed apps), installed_profiles (profiles on an Apple device), deployed_config_profiles (profiles Miradore deployed and their status), security, storage, os_updates (pending Apple updates), hardware, management (client/enrollment info), custom_attributes.

Summarise the whole fleet in one call: device counts by platform, online status and lifecycle status; OS versions in use; and lists of devices needing attention (not checked in for stale_days or more, no assigned user, passcode not set, encryption not enabled). Good for a daily check-in or 'is anything wrong?'.

Advanced read-only query against Miradore API v1 for anything the other tools don't cover (e.g. Category, Organization, Location, InvCertificate, ConfigProfileDeployment). 'select' lists attributes using dotted paths (e.g. 'InvDevice.Model', 'User.Email'); 'filters' uses operators eq, ne, gt, ge, lt, le, contains, notcontains, startswith, endswith, isempty, notisempty joined with and/or, quoting values with spaces. 'orderby' fields must also be selected. See the Miradore API v1 specification for attribute names.

List Miradore users (people devices can be assigned to), optionally filtered by email or name.

List device identifiers (serial numbers, IMEIs, etc.) pre-assigned to a user, so devices are linked to them automatically when they enroll.

List all tags defined in Miradore. Tags group devices and can drive business policies.

List configuration profiles defined in Miradore (Wi-Fi, restrictions, email, etc.) with their IDs, for use with deploy_config_profile.

List recent device enrollments, newest first. Use type 'DEP' for Apple Automated Device Enrollment. Helpful for confirming that a newly set-up device enrolled.

Get reported locations for a device (only if location tracking is enabled for it). Dates are optional.

List custom attributes configured in Miradore (IDs and names), for use with set_device_custom_attribute.

Get an application from the Miradore application catalog by its ID, including its deployment methods (needed for deploy_application). App IDs are visible in the Miradore console URL on the application's page.

List devices that are suspended in Miradore.

Ask Miradore to pull the latest device list from Apple Business/School Manager (Automated Device Enrollment / DEP) now instead of waiting for the scheduled sync. Rate limited by Miradore to once per minute. Note: assigning an enrollment profile to the synced devices must still be done in the Miradore console.

Pre-assign one or more device identifiers (serial numbers, IMEIs, etc.) to a user, so when those devices enroll they are linked to the user automatically. Use this before powering on a new device.

Remove a pre-assigned device identifier (e.g. serial number) from a user.

Add a tag to a device. Tags group devices and can trigger business policies that install apps and profiles.

Remove a tag from a device.

Deploy a configuration profile (from list_config_profiles) to a device.

Remove a configuration profile that Miradore deployed from a device.

Deploy an application to a device using one of the app's deployment methods. Look the app up with get_application to find its deployment method ID.

Update a device's assigned user, friendly name, ownership or category. Only the fields you give are changed. Use add_device_tag / remove_device_tag for tags.

Set a custom attribute value on a device. Find attribute IDs with list_custom_attributes.

Create a Miradore user that devices can be assigned to.

Update an existing Miradore user's name or phone number (looked up by email; email itself can't be changed).

Assign one or more tags to a user.

Remove a tag from a user.

Reactivate a device that was previously retired in Miradore.