This API retires a device.  Devices are retired based on a unique device ID (uuid).

https://<Ivanti EPMM>/api/v1/dm/devices/retire/ee8198d9-5d79-4961-94c4-e21bf04b2467?Reason=User%20replaced%20device

https://<Ivanti EPMM>/api/v1/dm/devices/retire/mac/38AA3C62BFAD?Reason=User%20replaced%20device

Register a Device

Retire a Device

EmailPlusiOSGuide.ACATG

GlobalBookTitles.SSIG

Ivanti Sentry Guide for Ivanti Neurons for MDM

GlobalBookTitles.MSGC

GlobalBookTitles.MSG

Ivanti EPMM Device Management Guide for iOS and macOS Devices

GlobalBookTitles.DMGi

Ivanti Neurons for MDM Administrator Guide

GlobalBookTitles.CAG

GlobalBookTitles.DMG_

EmailPlusiOSGuide.AAWG

GlobalBookTitles.AAWG

GlobalBookTitles.TIGA

GlobalBookTitles.ACATG

GlobalBookTitles.EIGA

Ivanti On-Premise Installation Guide for Core and Enterprise Connector

GlobalBookTitles.OPIG

GlobalBookTitles.SSIG-Standalone-Sentry-Installation-Guide

GlobalBookTitles.MSGC-Sentry-Guide-for-Cloud

GlobalBookTitles.MSG-Sentry-Guide-for-Core

Core Device Management Guide for iOS and macOS Devices

GlobalBookTitles.DMGi-Core-Device-Management-Guide-for-iOS-and-macOS-Devices

GlobalBookTitles.CAG-Cloud-Administrator-Guide

GlobalBookTitles.DMG_-Core-Device-Management-Guide

GlobalBookTitles.AAWG-Core-Apps@Work-Guide

GlobalBookTitles.TIGA-Tunnel-for-iOS-Guide

GlobalBookTitles.ACATG-AppConnect-Guide-for-Core

incappticConnect.incapptic_Full

incapptic Connect 1.44.0 - 1.50.0 Release Notes

incappticConnect.Release_Notes_title

incappticConnect.Release_month,_year

GlobalBookTitles.EAGA

GlobalBookTitles_new.MSGC

Ivanti On-Premise Installation Guide for Ivanti EPMM and Enterprise Connector

GlobalBookTitles.OPIG-Ivanti-On-Premise-Installation-Guide-for-Ivanti-EPMM-and-Enterprise-Connector

Primary.Company

Ivanti EPMM Device Management Guide for Android and Android Enterprise Devices

GlobalBookTitles.DMGA

GlobalBookTitles.TAGA

GlobalBookTitles_new.CAG

Primary.Product

GlobalBookTitles.MAG

GlobalBookTitles.GSCG

Primary.Product-Ivanti-Access-68-69

Ivanti Tunnel 4.14.0 - 4.15.0 for iOS Release Notes

Primary.Product-Ivanti-Tunnel-4.14.0-4.15.0-for-iOS-Release-Notes

GlobalBookTitles.DWIG

NewProdNames.Docs@Work

GlobalBookTitles.ACATG-Ivanti-AppConnect-Guide-for-EPMM

DocsAtWorkiOSGuide.AAWG

Ivanti EPMM Device Management Guide for iOS and macOS devices

GlobalBookTitles.DMGi-Ivanti-EPMM-Device-Management-Guide-for-iOS-and-macOS-devices

Ivanti Derived Credentials Guide for EPMM

GlobalBookTitles.DCG

GlobalBookTitles.MSG-Ivanti-Standalone-Sentry-Guide-for-EPMM

NewProdNames.Apps@Work

GlobalBookTitles_updated.DMG_

WebAtWorkForiOS.ACATG

GlobalBookTitles_updated.AAWG

GlobalBookTitles_updated.TIGA

GlobalBookTitles_updated.ACATG

GlobalBookTitles_updated.DMGi

GlobalBookTitles_updated.MSG

GlobalBookTitles_updated.MSGC

GlobalBookTitles_-_Copy.TIGA

Primary.Year

GlobalBookTitles.TAGA-Tunnel-for-Android-Guide

AppConnect for Android App Developers Guide

GlobalBookTitles.ACAD

Core Device Management Guide for Android and Android Enterprise Devices

GlobalBookTitles.DMGA-Core-Device-Management-Guide-for-Android-and-Android-Enterprise-Devices

GlobalBookTitles.MSGC-Sentry-Guide-for-Ivanti-Neurons-for-MDM

DocsAtWorkAndroidGuide.ACATG

Primary.Year-2026

Ivanti Neurons for MDM Guide Administrator Guide

GlobalBookTitles.CAG-Ivanti-Neurons-for-MDM-Guide-Administrator-Guide

Primary.Product-Ivanti-Tunnel-4.20.0-for-Android-Guide

Mobile Threat Defense Solution Guide for Cloud

GlobalBookTitles.MTDcloud

Primary.Product-Ivanti-Tunnel-4.19.0-4.20.0

Ivanti Tunnel 4.14.0 - 4.15.0 for iOS Guide

Primary.Product-Ivanti-Tunnel-4.14.0-4.15.0-for-iOS-Guide

GlobalBookTitles.MAGAiOS

TunneliOSGuide.MSG

Ivanti Tunnel 4.12.0 - 4.13.0 for macOS Release Notes

Primary.Product-Ivanti-Tunnel-4.12.0-4.13.0-for-macOS-Release-Notes

Ivanti Tunnel 4.12.0 - 4.13.0 for macOS Guide

Primary.Product-Ivanti-Tunnel-4.12.0-4.13.0-for-macOS-Guide

Primary.Product-Tunnel-1.2.3

AppVPNTunnelForWindows12.MSG

incappticConnect.incapptic_Full-Ivanti-incapptic-Connect

Primary.Product-Ivanti-incapptic-Connect-1.44.0-1.50.0

Print.Guide

MI.product

EE.product

PrimaryMI.product

Primary.Product-Neurons-for-MDM-125

a list of users that you want to treat in the same way.

user group

a message or alert that is sent to the device. As per Apple, Push notifications to offline devices are based on APNs offline storage policy.

push notifications

a list of mobile apps you have made available for your users. Includes apps that users can download from public app stores and apps you intend to distribute using the device management system (In-house apps).

app catalog

collections of settings that you send to devices.

configurations

sets of requirements and compliance actions defined for devices.

policies

PrimaryMI.license2

an app distributed by the device management service rather than downloaded from a public app store.

in-house app

PrimaryMI.app

EE.app

PrimaryMI.license3

files that are published by and distributed to users.

content

a list of files that have been published by and distributed to users. A typical catalog might include sales presentations, images, spreadsheets, and documents.

content catalog

EE.license3

applications that are allowed on a device. A device that has other apps installed is considered out of compliance.

Allowlist apps

applications that are not approved for installation on a device. A device that has any of these apps installed is considered out of compliance.

Blockedlist apps

applications that must be installed on a device. A device that is missing any of these apps is considered out of compliance.

required apps

automated responses to a device that violates rules for managed devices.

compliance actions

PrimaryMI.license1

A third-party vendor translates this Administrator Guide into many languages. The accelerated release cadence of Ivanti Neurons for MDM means that sometimes there is a delay in publishing translated content. If your non-English Administrator Guide is out of date, please access the latest content in the English language by accessing the URL, http://[base Administrator Guide URL]/xx/all/en-us/LandingPage.htm, where [base Administrator Guide URL] is the address after http:// and before the latest Ivanti Neurons for MDM version number, and xx is the latest version number of Ivanti Neurons for MDM. For example, to access release 91 online help, the URL would be http://[base Administrator Guide URL]/91/all/en-us/LandingPage.htm.

If your language is unavailable

NewProdNames.Cloud

Ivanti Standalone Sentry 9.14.0 - 10.8.2 Release Notes

1. URI: https:///api/v1/dm/devices/retire/	Device with the input device uuid is retired
Http Method:	PUT
Format:	xml, json
Request:
Device uuid	Required. Unique ID of the device. This ID can be retrieved in the response of other API calls, such as Device Registration or Get Device Details.
Reason	Free form text field (512 character limit) to display reason why the device is being retired.

2. URI: https:///api/v1/dm/devices/retire/mac/	Device with the input Wi-Fi MAC address is retired.
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 retired.

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> Device is retired successfully.</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>