# Retrieves the edit-mode configuration details of the specified scheduled Wake on LAN task

Returns the configuration details of the specified Wake on LAN task in edit mode, including task name, target settings, schedule, and current status. Used to populate the edit task form.

## Endpoint

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

### Request URL

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

### Scope

`Tools.READ`

### 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 GET \
  --url https://appdomain/dcapi/tools/wol/tasks/{taskId} \
  --header 'Accept: application/json' \
  --header 'Authorization:  d92d4xxxxxxxxxxxxx15f52'
```

## Response Parameters

### HTTP Code 200

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

`JSON Object`

- **taskId** `long`: Scheduled WOL task unique identifier
- **taskName** `string`: User-defined task name
- **platform** `integer`: Target platform: 1=Windows
- **status** `string`: Task status: Active, Suspended
- **scheduleType** `string`: Schedule type: once, daily, weekly, monthly
- **nextRunTime** `long`: Next scheduled execution time (epoch)

## Sample Response: HTTP 200

```json
{
  "nextRunTime": 1711425600000,
  "scheduleType": "daily",
  "targetValue": "Engineering",
  "taskName": "Morning WOL",
  "targetType": "CustomGroup",
  "taskId": 18,
  "platform": 1,
  "status": "Active"
}
```

## Possible Response Codes

- **200**: HTTP code

## 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.