# Permanently remove an EDR exclusion rule

Permanently removes an existing exclusion rule identified by the exclusionId path parameter. The operation is customer-scoped and audit-tracked using the ID of the logged-in user.

## Endpoint

`DELETE /edr/api/ext/exclusion/{exclusion_id}`

## Request URL

`https://{server-hostname}:8383/edr/api/ext/exclusion/{exclusion_id}`

## Scope

`EDR.DELETE`

### Header

`Authorization: d92d4xxxxxxxxxxxxx15f52`

## Request Parameters

### Request Headers

- **Content-Type** (`string`, Mandatory): `application/json`

### Path Parameters

- **exclusion_id** (`string`, Mandatory): A unique identifier assigned to each exclusion that is added. Get the exclusion ID from [Get Exclusion details](https://www.manageengine.com/products/desktop-central/help/api/onpremise/edrview-exclusion-get-exclusions.html).

### Query Parameters

- **pageLimit** (`integer`, Optional)
- **page** (`integer`, Optional)
- **searchColumn** (`string`, Optional)
- **searchValue** (`string`, Optional)

## Sample Request

```curl
curl --request DELETE \
  --url 'https://appdomain/edr/api/ext/exclusion/{exclusion_id}?pageLimit=SOME_INTEGER_VALUE&page=SOME_INTEGER_VALUE&searchColumn=SOME_STRING_VALUE&searchValue=SOME_STRING_VALUE' \
  --header 'Authorization:  d92d4xxxxxxxxxxxxx15f52' \
  --header 'Content-Type: application/json'
```

## Response Parameters

### HTTP Code 400

#### Response Body — application/json

**JSON Object**

- **errorCode** (`string`): `EDRCOMMON001` — Internal server error occurred while deleting the exclusion rule.
- **errorMessage** (`string`): General internal error message.

### HTTP Code 429

#### Response Body — application/json

**JSON Object**

- **errorCode** (`string`): Rate limit error code.  
  `IAM0019` — Returned when the API call threshold is exceeded within the defined duration window.
- **errorMessage** (`string`): Rate limit exceeded message with guidance on when to retry.

## Sample Response: HTTP 200

```text
200 OK
```

## Sample Response: HTTP 400

Unexpected server-side error

```json
{
  "errorMessage": "Exception while delete exclusion",
  "errorCode": "EDRCOMMON001"
}
```

## Sample Response: HTTP 429

API call threshold exceeded

```json
{
  "errorCode": "IAM0019",
  "url": "/edr/api/ext/exclusion/{exclusion_id}",
  "errorMsg": "The URL /edr/api/ext/exclusion/{exclusion_id} was called too many times. Please retry after a while."
}
```

![ ](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.