Wipe a Device
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: 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: 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. Success is shown if the method execution is successful. A descriptive error message is shown if the method execution failed. |
</messages> | |
| |
<deviceUuid>caba40e7-f56b-44aa-ac70-79e32e91adf8</deviceUuid> | Unique device ID. |
< /deviceManagementWebServiceResponse> | |
| |
