---
title: Cancel retire devices
slug: epmm/v2-api-guide/cancel-retire-devices
createdAt: 2026-10-06T08:06:40.649Z
---

This call cancels retire devices.

### Required Role

See [Authentication](docId\:hJ6Ul2Sz4DNsmnPJ-Fxl_) for complete details on ensuring that the credentials you use for basic authentication belong to a user with the necessary role for this API call.

| Required Role                                                            |
| ------------------------------------------------------------------------ |
| **Category:** Device Management<br />**Role Description:** Retire device |

### HTTP method

PUT

### Request URI

api/v2/devices/cancelretire

### Request parameters

| Parameter          | Description                                                                                                                          | Sample Value                                                                                                                                                                |
| ------------------ | ------------------------------------------------------------------------------------------------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| adminDeviceSpaceId | **Required**<br />**Parameter Type:** Query<br />**Data Type:** Number<br />Device space ID of the administrator.                    | 1                                                                                                                                                                           |
| deviceUuids        | **Required**<br />**Parameter Type:** Request body<br />**Data Type:** String<br />The device UUIDs of the devices to cancel retire. | <br />`{`<br />`    "deviceUuids": [`<br />`        "3d394988-f5a0-45b6-9958-2d30c8e21ccd"`<br />`     ],  `<br />`     "note":  `<br />`       "alert(\"Test\")"`<br />`}` |
| note               | **Parameter Type:** Request body<br />**Data Type:** String<br />Note clarifying the cancel retire request.                          | "note": "alert(\\"Test\”)”                                                                                                                                                  |

### Response fields

| Field                 | Description                                             |
| --------------------- | ------------------------------------------------------- |
| results               | Container for results.                                  |
|         resultId      | ID of the result.                                       |
|         resultMessage | Message for the result.                                 |
|         records       | List of devices affected.                               |
| resultCount           | Count of devices affected.                              |
| actionType            | Describes the action type, in this case, CANCEL RETIRE. |
| deviceResults         | Indicates the outcome for the action per device.        |
| successful            | Indicates success, true or false.                       |

### Sample request and response

### Request

curl --location --request PUT 'https\://\[Ivanti EPMM]/api/v2/devices/cancelretire?adminDeviceSpaceId=1' \\

\--header 'Content-Type: application/json' \\

\--data ' \{"deviceUuids": \["3d394988-f5a0-45b6-9958-2d30c8e21ccd"], "note": "alert(\\"Test\\")"}'

### Response

```javascript
{
    "results": [
        {
            "resultId": "114", 
            "resultMessage": null, 
            "records": [
                "3d394988-f5a0-45b6-9958-2d30c8e21ccd"
            ]
        }
    ], 
    "resultCount": 1, 
    "actionType": "CANCEL_RETIRE", 
    "deviceResults": {
        "3d394988-f5a0-45b6-9958-2d30c8e21ccd": "Device Action Successful"
    }, 
    "successful": true
}
```