---
title: Wipe a Device
slug: epmm/v1web-service-api-guide/wipe-a-device
createdAt: 2026-11-03T13:29:39.541Z
---

This API wipes a device, which returns its settings to the factory defaults. Once wiped, device status changes to “Wiped,” and the only valid action to apply is Retire. A wipe call is based on a unique device ID (uuid). 

You can use this API with ServiceNow.

**Example**:

https\://\<Ivanti EPMM>/api/v1/dm/devices/wipe/ee8198d9-5d79-4961-94c4-e21bf04b2467?Reason=Device%stolen

https\://\<Ivanti EPMM>/api/v1/dm/devices/wipe/38AA3C62BFAD?Reason= Device%stolen

| 1.URI:<br />https\:///api/v1/dm/devices/wipe/                   | Device with the input device uuid is wiped.                                                                                                            |
| --------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Http Method:                                                    | PUT                                                                                                                                                    |
| Format:                                                         | xml, json                                                                                                                                              |
| Request:                                                        |                                                                                                                                                        |
| Device UUID                                                     | Required. Unique ID of the device. This ID is sent in the response of the Registration API.                                                            |
| Reason                                                          | Free form text field (512 character limit) to display reason why the device is being wiped.                                                            |
|                                                                 |                                                                                                                                                        |
| 2.URI:<br />https\:///api/v1/dm/devices/wipe/mac/               | Device with the input device Wi-Fi MAC address is wiped.                                                                                               |
| Http Method:                                                    | PUT                                                                                                                                                    |
| Format:                                                         | xml, json                                                                                                                                              |
| Request:                                                        |                                                                                                                                                        |
| macAddress                                                      | Required.                                                                                                                                              |
| Reason                                                          | Free form text field (512 character limit) to display reason why the device is being wiped.                                                            |
|                                                                 |                                                                                                                                                        |
| Response Status Code:                                           |                                                                                                                                                        |
| ‘404 – No Data Found’                                           | There is no data.                                                                                                                                      |
| ‘200 – OK’                                                      | Data is present and the response is returned.                                                                                                          |
| Response:                                                       |                                                                                                                                                        |
| \< deviceManagementWebServiceResponse>                          |                                                                                                                                                        |
| \<messages>                                                     |                                                                                                                                                        |
| \<message>\</message>                                           | Status Message.<br />Success is shown if the method execution is successful.<br />A descriptive error message is shown if the method execution failed. |
| \</messages>                                                    |                                                                                                                                                        |
|                                                                 |                                                                                                                                                        |
| \<deviceUuid>caba40e7-f56b-44aa-ac70-79e32e91adf8\</deviceUuid> | Unique device ID.                                                                                                                                      |
| \< /deviceManagementWebServiceResponse>                         |                                                                                                                                                        |
|                                                                 |                                                                                                                                                        |