# Enable lost mode on the managed device

sends enable lost mode command to device

## Endpoints

**POST** `/api/v1/mdm/devices/{device_id}/actions/enable_lost_mode`

## Request URL

```text
https://{server-hostname}:8383/api/v1/mdm/devices/{device_id}/actions/enable_lost_mode
```

## Scope

```text
MDMInventory.CREATE
```

## Header

```text
Authorization: d92d4xxxxxxxxxxxxx15f52
```

## Request Parameters

### Request Headers

- **Content-Type** `string` **Mandatory**: `application/json`
- **Accept** `string` **Mandatory**: `application/json`

### Path Parameters

- **device_id** `string` **Mandatory**

  Unique identifier of the device. Obtain from the [Get Device List](https://www.manageengine.com/products/desktop-central/help/api/onpremise/devices-get-device-list.html) response

### Request Body

`application/json`

`JSON Object`

- **phone_number** `string` Optional

  Contact phone number displayed on the lost device

- **lock_message** `string` Optional

  Message displayed on the lost device lock screen

- **lost_mode_title** `string` Optional

  Title displayed on the device in lost mode

- **footnote** `string` Optional

  Footnote displayed on the device in lost mode

- **audit_message** `string` Optional

  Audit message for the action

- **ticket_id** `string` Optional

  Associated ticket ID for the action

- **send_email_to_user** `boolean` Optional

  Send email to user when lost mode is enabled

- **send_email_to_admin** `boolean` Optional

  Send email to admin when lost mode is enabled

- **passcode** `string` Optional

  Passcode for lost mode

- **do_not_notify** `boolean` Optional

  Do not notify the user about the action

## Sample Request

```curl
curl --request POST \
  --url https://appdomain/api/v1/mdm/devices/{device_id}/actions/enable_lost_mode \
  --header 'Accept: application/json' \
  --header 'Authorization:  d92d4xxxxxxxxxxxxx15f52' \
  --header 'Content-Type: application/json' \
  --data '{"send_email_to_user":"true","lock_message":"This device has been lost. Please contact the administrator.","send_email_to_admin":"true","lost_mode_title":"Device Lost","do_not_notify":"false","phone_number":"+1-555-0****00","audit_message":"Device reported lost by user","footnote":"Kindly contact administrator","ticket_id":"9007199254741090","passcode":"1234"}'
```

## Sample Request Body

Enable lost mode with contact details

```json
{
  "send_email_to_user": "true",
  "lock_message": "This device has been lost. Please contact the administrator.",
  "send_email_to_admin": "true",
  "lost_mode_title": "Device Lost",
  "do_not_notify": "false",
  "phone_number": "+1-555-0****00",
  "audit_message": "Device reported lost by user",
  "footnote": "Kindly contact administrator",
  "ticket_id": "9007199254741090",
  "passcode": "1234"
}
```

## Possible Response Codes

- **202** HTTP code

## Sample Response: HTTP 202

```text
202 Accepted
```

![](https://www.zohowebstatic.com/sites/zweb/images/people/ico-help.png)

**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.