post https://yourServer.jamfcloud.com/JSSResource/mobiledevicecommands/command
The chart below includes additional requirements for usage of specific commands
| command | Parameters | Requirements | Values |
|---|---|---|---|
| DeviceLocation | N/A | Supervised and in lost mode | N/A |
| DisableLostMode | N/A | Supervised and in lost mode | N/A |
| EnableLostMode | lost_mode_message | Supervised device (required if lost_mode_phone is not set) | string |
| EnableLostMode | lost_mode_phone | Supervised device (required if lost_mode_message is not set) | string |
| EnableLostMode | lost_mode_footnote | optional | string |
| EnableLostMode | always_enforce_lost_mode | optional (defaults to 'true') | boolean |
| EnableLostMode | lost_mode_with_sound | optional (defaults to 'false') | boolean |
| PasscodeLockGracePeriod (PasscodeLockGracePeriod Deprecated on 2025-06-26) | passcode_lock_grace_period | Shared iPad | seconds (integer) |
| PlayLostModeSound | N/A | Supervised and in lost mode | N/A |
| RestartDevice (deprecated) | N/A | Supervised device | N/A |
| Wallpaper | wallpaper_settings | Supervised device | 1 = Lock screen, 2 = Home screen, 3 = both |
| Wallpaper | wallpaper_id | Supervised device (required if wallpaper_content is not set) | Jamf Pro icon ID (integer) |
| Wallpaper | wallpaper_content | Supervised device (required if wallpaper_id is not set) | base64 encoded PNG or JPEG |
| RefreshCellularPlans (RefreshCellularPlans deprecated on 2025-07-15) | e_sim_server_url | N/A | This URL is obtained from each carrier separately |
Below is a complete list of the supported values for the command element.
- BlankPush (deprecated)
- ClearPasscode
- DeviceLocation
- DisableLostMode
- EnableLostMode
- PasscodeLockGracePeriod
- PlayLostModeSound
- RefreshCellularPlans
- RestartDevice (deprecated)
- UpdateInventory
- Wallpaper
Below you will find a list of sample request bodies for commands that have additional parameters beyond the command.
<mobile_device_command>
<general>
<command>EnableLostMode</command>
<lost_mode_message>This device has been reported as lost and its location has been identified, please return before authorities arrive.</lost_mode_message>
<lost_mode_phone>555-555-5555</lost_mode_phone>
<lost_mode_footnote>This is an optional footnote</lost_mode_footnote>
<always_enforce_lost_mode>false</always_enforce_lost_mode>
<lost_mode_with_sound>false</lost_mode_with_sound>
</general>
<mobile_devices>
<mobile_device>
<id>4</id>
</mobile_device>
</mobile_devices>
</mobile_device_command><mobile_device_command>
<general>
<command>PasscodeLockGracePeriod</command>
<passcode_lock_grace_period>60</passcode_lock_grace_period>
</general>
<mobile_devices>
<mobile_device>
<id>4</id>
</mobile_device>
</mobile_devices>
</mobile_device_command><mobile_device_command>
<general>
<command>Wallpaper</command>
<wallpaper_setting>1</wallpaper_setting>
<wallpaper_id>1</wallpaper_id>
<wallpaper_content></wallpaper_content>
</general>
<mobile_devices>
<mobile_device>
<id>4</id>
</mobile_device>
</mobile_devices>
</mobile_device_command>