Lock Device
This endpoint sends an MDM command to remotely lock a device.
For macOS clients, an unlock PIN will be created, and returned in the response.
> Caution !!!
> For a Mac with Apple silicon running a version of macOS before 11.5 deactivates the Mac. To reactivate, the Mac requires a network connection and authentication by a Secure Token enabled local administrator.
Responses codes
- 200 OK
- 400 Bad Request
- "Command already running" - The command may already be running in a Pending state waiting on the device.
- 401 Unauthorized
- Invalid access token. This can happen if the token was revoked, the required permissions are missing, or the token has expired.
- 404 Not found
- Unable to locate the resource in the Kandji instance.
Parameters
Parameter | Description |
---|---|
Device ID | - |
Example Output
{
"PIN": "496406"
}
Workflow Library Example
Lock Device with Kandji and Send Results Via Email