---
title: "Void agent"
source_url: https://dev.digicert.com/certcentral-apis/automation-api/void-agent.html
api_method: POST
api_endpoint: "/automationws/v1/agent/void"
api_url: "https://caas.digicert.com/automationws/v1/agent/void"
---

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

Use this endpoint to void an agent. Use this operation when the agent is duplicated or no longer in use.

## Example requests and responses

## cURL

```bash
curl --location --request POST 'https://caas.digicert.com/automationws/v1/agent/void' \
--header 'X-DC-DEVKEY: {{api_key}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "accountId": 5153184,
    "reason": "No longer in use",
    "identifiers": [
        "C4518024C883BB79"
    ],
    "divisionIds": [
        "677793"
    ]
}'
```

## 200 OK

```json
{
    "error": null,
    "data": "Agent updated successfully"
}
```

## 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>accountId</td>
<td>required</td>
<td>string</td>
<td>Account ID.</td>
</tr>
<tr>
<td>reason</td>
<td>optional</td>
<td>string</td>
<td>Reason for voiding the agent.</td>
</tr>
<tr>
<td>identifiers</td>
<td>required</td>
<td>array</td>
<td>License keys associated with the agents.</td>
</tr>
<tr>
<td>divisionIds</td>
<td>required</td>
<td>array</td>
<td>Division IDs.</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>Message with information about the request.</td>
</tr>
<tr>
<td>.. data</td>
<td>object</td>
<td>Object with details about the voided agent details.</td>
</tr>
<tr>
<td>.. .. id</td>
<td>string</td>
<td>License key of the voided agent.</td>
</tr>
<tr>
<td>.. .. message</td>
<td>string</td>
<td>Message with information about the request.</td>
</tr>
</tbody>
</table>