# Permanently deletes the specified scheduled Wake on LAN task

Permanently removes the specified scheduled Wake on LAN task from the system. The task is identified by its task ID in the URL path.

## Endpoints

`DELETE /dcapi/tools/wol/tasks/{taskId}`

## Request

### Request URL

`https://{server-hostname}:8383/dcapi/tools/wol/tasks/{taskId}`

### Scope

`Tools.DELETE`

### Header

`Authorization: d92d4xxxxxxxxxxxxx15f52`

### Request Parameters

#### Request Headers

- **Accept** `string` — **Mandatory** — `application/json`

#### Path Parameters

- **taskId** `string` — **Mandatory**
  - The unique identifier of the task

### Sample Request

```curl
curl --request DELETE \
  --url https://appdomain/dcapi/tools/wol/tasks/{taskId} \
  --header 'Accept: application/json' \
  --header 'Authorization:  d92d4xxxxxxxxxxxxx15f52'
```

## Response

### Response Parameters

#### HTTP Code 200

Response Body — `application/json`

- `JSON Object`
  - **status** `string`
    - Result of the operation: success or failure

### Possible Response Codes

- **200** `HTTP code`

### Sample Response: HTTP 200

```json
{
  "status": "success"
}
```

## Rate Limits

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