Lock Device

Category Filter

Lock a device.

Argument	Type	Description
message	String	Optional. Message to be displayed on the device
phone_number	String	Optional. Phone number
user	Array	Optional. IDs of the users
usergroup	Array	Optional. IDs of the user groups
device	Array	Optional. IDs of the devices
devicegroup	Array	Optional. IDs of the device groups
system_lock_pin	String	Required for macOS devices without Apple Silicon Chip. A 6-digit PIN to unlock the device.

curl

HTTP Request:

 POST https://<portal>.hexnodemdm.com/api/v1/actions/lock_devices/
headers:-
Authorization: <api key>
Content-Type: application/json
Sample Post Data:-
[{
"users":[0],
"usergroups":[4],
"devices":[5,6],
"devicegroups":[12],
"message":"Hai",
"phone_number":4167729912
"system_lock_pin":123456
}]

POST https://<portal>.hexnodemdm.com/api/v1/actions/lock_devices/

headers:-

Authorization: <api key>

Content-Type: application/json

Sample Post Data:-

[{

"users":[0],

"usergroups":[4],

"devices":[5,6],

"devicegroups":[12],

"message":"Hai",

"phone_number":4167729912

"system_lock_pin":123456

}]

Shell Command:

curl  -H "Authorization: <your API key>" -H "Content-Type: application/json" -d '{"users":[0],"usergroups":[4],"devices":[5,6],"devicegroups":[12],"message":"Hai","phone_number":999}'  https://<portal>.hexnodemdm.com/api/v1/actions/lock_devices/

1	curl -H "Authorization: <your API key>" -H "Content-Type: application/json" -d '{"users":[0],"usergroups":[4],"devices":[5,6],"devicegroups":[12],"message":"Hai","phone_number":999}' https://<portal>.hexnodemdm.com/api/v1/actions/lock_devices/

HTTP Response:

HTTP/1.1 200 ok

1	HTTP/1.1 200 ok