sends device lock command to device
post /api/v1/mdm/devices/{device_id}/actions/lock
https://{server-hostname}:8383/api/v1/mdm/devices/{device_id}/actions/lock
MDMInventory.CREATECopied!
Authorization: d92d4xxxxxxxxxxxxx15f52
Unique identifier of the device. Obtain from the Get Device List response
Message displayed on the device lock screen
Phone number to display on the device during lock
Unlock PIN for the device
Whether email is sent to the user
curl --request POST \
--url https://appdomain/api/v1/mdm/devices/{device_id}/actions/lock \
--header 'Accept: application/json' \
--header 'Authorization: d92d4xxxxxxxxxxxxx15f52' \
--header 'Content-Type: application/json' \
--data '{"unlock_pin":"1234.","lock_message":"This device has been locked by the administrator.","email_sent_to_user":"true.","phone_number":"000000000000."}'Lock device with a lock screen message
{
"unlock_pin": "1234.",
"lock_message": "This device has been locked by the administrator.",
"email_sent_to_user": "true.",
"phone_number": "000000000000."
}
202 Accepted![]()
Duration: 1 minute | Threshold: 30 | Lock period: 5 minutes
Duration - Time window for the threshold.
Threshold - Number of API calls allowed within the specified duration.
Lock Period - Wait time before consecutive API requests.
© 2026, Zoho Corporation Pvt. Ltd. All Rights Reserved.
© 2026, Zoho Corporation Pvt. Ltd. All Rights Reserved.