---
title: "Get agent advanced settings"
source_url: https://dev.digicert.com/certcentral-apis/automation-api/get-agent-advanced-settings.html
api_method: POST
api_endpoint: "/automationws/v1/agent/advancesettings"
api_url: "https://caas.digicert.com/automationws/v1/agent/advancesettings"
---

**POST** `https://caas.digicert.com/automationws/v1/agent/advancesettings`

Use this endpoint to get advanced settings details for an automation agent, such as the agent's communication interval (also known as the *heartbeat interval*) and the debug log level settings.

## Example requests and responses

## cURL

```bash
curl --location --request POST 'https://caas.digicert.com/automationws/v1/agent/advancesettings' \
--header 'X-DC-DEVKEY: {{api_key}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "licenseKey": "3D8B9DE411965F6F",
    "divisionId": 677793,
    "accountId": 5153184
}'
```

## 200 OK

```json
{
    "error": null,
    "data": {
        "heartbeatInterval": 30,
        "programLogs": {
            "startNow": false,
            "startAt": 1605891600000,
            "manually": false,
            "stopOn": 1605915000000,
            "timezone": "5:30#chennai",
            "stopTimezone": "5:30#chennai"
        }
    }
}
```

## Request parameters

<table class="params-table">
<thead>
<tr>
<th>Name</th>
<th>Req/Opt</th>
<th>Type</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td>licenseKey</td>
<td>required</td>
<td>string</td>
<td>License key associated with the agent.</td>
</tr>
<tr>
<td>divisionId</td>
<td>required</td>
<td>long</td>
<td>Division ID.</td>
</tr>
<tr>
<td>accountId</td>
<td>required</td>
<td>string</td>
<td>Account ID.</td>
</tr>
</tbody>
</table>

## Response parameters

<table class="params-table">
<thead>
<tr>
<th>Name</th>
<th>Type</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td>error</td>
<td>object</td>
<td>Object with error details, if any.<br>Note: Returns null if there are no errors.</td>
</tr>
<tr>
<td>data</td>
<td>object</td>
<td>Object with response data.</td>
</tr>
<tr>
<td>.. heartbeatInterval</td>
<td>integer</td>
<td>Agent heartbeat interval (in seconds).</td>
</tr>
<tr>
<td>.. programLogs</td>
<td>object</td>
<td>Object with details about the debug log level settings.</td>
</tr>
<tr>
<td>.. .. startNow</td>
<td>boolean</td>
<td>If <code>true</code>, the system received a request to immediately change the log level from "error" to "debug".</td>
</tr>
<tr>
<td>.. .. startAt</td>
<td>integer</td>
<td>Time when the system is scheduled to automatically enable the debug log level.<br>Format:  epoch in milliseconds.<br>Example: 1596781119000</td>
</tr>
<tr>
<td>.. .. manually</td>
<td>boolean</td>
<td>If <code>true</code>, a user must manually disable the debug log level.</td>
</tr>
<tr>
<td>.. .. stopOn</td>
<td>integer</td>
<td>Time when the system is scheduled to automatically disable the debug log level.<br>Format:  epoch in milliseconds.<br>Example: 1596781119000</td>
</tr>
<tr>
<td>.. .. timezone</td>
<td>string</td>
<td>Time zone for the agent to start the debug log.<br>Format: GMT+ your timezone offset<br>Example: -8#pacifictime</td>
</tr>
<tr>
<td>.. .. stopTimezone</td>
<td>string</td>
<td>Time zone for the agent to stop the debug log.<br>Format: GMT+ your timezone offset<br>Example: -8#pacifictime</td>
</tr>
</tbody>
</table>