# Suspends a scheduled Wake on LAN task from its next execution

Suspends the specified scheduled Wake on LAN task, preventing it from being executed on its next scheduled time. The task remains in the system and can be resumed.

## Endpoint

`PUT /dcapi/tools/wol/tasks/{taskId}/suspend`

## Request URL

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

## Scope

`Tools.UPDATE`

## Header

`Authorization: d92d4xxxxxxxxxxxxx15f52`

## Request Parameters

### Request Headers

- **Content-Type** `string` **Mandatory**: `application/suspendInfo.v1+json`

### Path Parameters

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

## Sample Request

```curl
curl --request PUT \
  --url https://appdomain/dcapi/tools/wol/tasks/{taskId}/suspend \
  --header 'Authorization:  d92d4xxxxxxxxxxxxx15f52' \
  --header 'Content-Type: application/suspendInfo.v1+json'
```

## Response Parameters

### HTTP Code 200

#### Response Body: `application/json`

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

## Sample Response: HTTP 200

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

## Possible Response Codes

- **200** `HTTP code`

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