Before you start
- An Iru API token with MCP turned on and permissions that cover the calls below (recipe 1).
- A supervised iPhone or iPad, enrolled in Iru and reachable over the internet. Automated Device Enrollment is the simplest way to supervise.
- Lost Mode doesn't work on Mac. It relies on Apple's Managed Lost Mode, which is iPhone and iPad only.
Prompt for your agent
Find the iPhone or iPad assigned to [user name or serial number] in Iru and show me its name, model and serial number. Then stop and wait for my approval. After I approve, turn on Lost Mode with this lock screen message: "[message]" and phone number [number]. Then show me the device's Lost Mode details, including its location.
Steps
Find the device
Have the agent find the device by its user or serial number and confirm it's an iPhone or iPad. The
lost_mode_statusfield applies only to iOS and iPadOS.GET/api/v1/devicesSource: Iru API: List Devices
Turn on Lost Mode after you approve
Send a Message, PhoneNumber and optional Footnote for the lock screen. The web app asks for at least a message or a phone number.
POST/api/v1/devices/{device_id}/action/enablelostmodeApproval requiredThe agent shows you the device and the lock screen text, then waits for your go.
Source: Enable Lost Mode
Check the location
Iru requests the location when Lost Mode turns on, then every 15 minutes until you turn it off. Ask for a fresh location at any time.
GET/api/v1/devices/{device_id}/details/lostmodePOST/api/v1/devices/{device_id}/action/updatelocationSource: Enable Lost Mode
Turn off Lost Mode once you have the device
Turning off Lost Mode removes the Lost Mode tab and deletes all location information from Iru. If the command is already pending, the response says so.
POST/api/v1/devices/{device_id}/action/disablelostmodeApproval requiredThe agent confirms the device is back in hand before it sends the command.
Source: Enable Lost Mode
Check it worked
- The device shows the Lost Mode lock screen as soon as it receives the command.
- The device activity stream lists each Lost Mode command with its timestamp and the user who sent it.
- After you turn it off, the device shows a notification that Iru gathered its location, and when.
Common pitfalls
- Don't restart a passcode-protected, Wi-Fi only device while it's in Lost Mode. It needs the passcode to reach Wi-Fi after a restart, and the Lost Mode lock screen blocks passcode entry.
- Iru alerts you when the device moves 50 meters (about 160 feet) or more since its last position.
- If someone is near the device, Play Sound in the web app plays the Lost Mode sound for 2 minutes, even in silent mode.
FAQ
Which devices support Lost Mode?
Supervised iPhone and iPad. Lost Mode isn't available on Mac.
What shows on the lock screen?
A message, a phone number and a footnote (Message, PhoneNumber and Footnote in the API). The web app needs at least a message or a phone number.
How often does the location update?
Iru requests a location when Lost Mode turns on, then every 15 minutes. Update Location requests a fresh one, and Iru alerts when the device moves 50 m (about 160 ft) or more.
What happens when I turn Lost Mode off?
Disable Lost Mode deletes the location information. If the command is already pending, the API response says so.