# Updates the Wake on LAN global configuration settings

Saves the Wake on LAN global configuration including the WOL UDP port, wait time between retry attempts, and whether automatic settings detection is enabled. The 'actionCall' query parameter specifies the settings action type.

## Endpoint

**POST** `/dcapi/tools/wol/settings`

## Request

### Request URL

https://*[serverurl](https://www.manageengine.com/products/desktop-central/help/api/cloud/oauth-authentication-endpoint-domain.html)*/dcapi/tools/wol/settings

### Scope

`DesktopCentralCloud.Tools.UPDATE`

### Header

`Authorization: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52`

## Request Parameters

### Request Headers

- **Content-Type** (`string`, Mandatory): `application/wolSettings.v1+json`

### Query Parameters

- **actionCall** (`string`, Optional): Specifies the WOL automation settings operation to perform. Accepted values: 'saveSettings' (persist updated automation settings), 'showSettings' (retrieve current automation setting values)

### Request Body

`application/json`

- JSON Object
  - **waitTime** (`string`, Optional)
  - **wolPort** (`string`, Optional)
  - **enableWolAutoSettings** (`boolean`, Optional)

## Sample Request

```curl
curl --request POST \
  --url https://appdomains/dcapi/tools/wol/settings \
  --header 'Authorization: Zoho-oauthtoken  d92d4xxxxxxxxxxxxx15f52' \
  --header 'Content-Type: application/wolSettings.v1+json' \
  --data '{}'
```

## Sample Request Body

```json
{
  "wolPort": 9,
  "enableWolAutoSettings": true,
  "waitTime": 5
}
```

## 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"
}
```

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