---
title: "Bulk retry automation"
source_url: https://dev.digicert.com/certcentral-apis/automation-api/bulk-retry-automation.html
api_method: POST
api_endpoint: "/automationws/v1/automation/bulkretryautomationtask"
api_url: "https://caas.digicert.com/automationws/v1/automation/bulkretryautomationtask"
---

**POST** `https://caas.digicert.com/automationws/v1/automation/bulkretryautomationtask`

Use this endpoint to retry automating tasks in bulk when there is a failure. Fix issues that caused the initial automation request to fail before retrying.

For more information, see <a href="https://docs.digicert.com/en/certcentral/certificate-tools/certificate-lifecycle-automation-guides/certificates-eligible-for-retry.html" target="_blank" rel="noopener noreferrer">Certificates eligible for retry.</a>

## Example requests and responses

### Retry an eligible or ineligible automation

## cURL

```bash
curl --location --request POST 'https://caas.digicert.com/automationws/v1/automation/bulkretryautomationtask' \
--header 'X-DC-DEVKEY: {{api_key}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "retryAutomationTaskRequests": [{
        "ip": "10.100.193.54",
        "port": 55085,
        "accountId": 5153184,
        "divisionId": 677793,
        "domainName": null,
        "agentLicenseKey": "58C5D9FD5BC95FAA"
    }, {
        "ip": "10.100.193.54",
        "port": 55084,
        "accountId": 5153184,
        "divisionId": 677793,
        "domainName": null,
        "agentLicenseKey": "58C5D9FD5BC95FAA"
    }, {
        "ip": "10.100.197.150",
        "managementIp": "10.100.192.246",
        "port": 1900,
        "accountId": 5153184,
        "divisionId": 677793,
        "domainName": null,
        "virtualServerName": "/Common/ManualDigi",
        "sensorLicenseKey": "2F88E69451FAE5C8"
    }],
    "accountId": 5153184
}'
```

## 200 OK

```json
{
   "error": null,
    "data": {
        "retryMessages": {
            "10.100.193.54:55084": "Successfully initiated retry.",
            "10.100.193.54:55085": "Successfully initiated retry."
        },
        "failedRetries": {
            "10.100.197.150:1900": {
                "errors": [{
                    "errorCode": "1028",
                    "errorField": "10.100.197.150:1900",
                    "errorMessage": "Automated IP/Port is not eligible for retry."
                }],
                "status": {}
            }
        },
        "message": "2 of 3 automations submitted for retry.",
        "errors": [],
        "status": {}
    }
}
```

### Retry all eligible automation

## cURL

```bash
curl --location --request POST 'https://caas.digicert.com/automationws/v1/automation/bulkretryautomationtask' \
--header 'X-DC-DEVKEY: {{api_key}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "retryAutomationTaskRequests": [{
        "ip": "10.100.193.54",
        "port": 55084,
        "accountId": 5153184,
        "divisionId": 677793,
        "domainName": null,
        "agentLicenseKey": "58C5D9FD5BC95FAA"
    }, {
        "ip": "10.100.193.54",
        "port": 55085,
        "accountId": 5153184,
        "divisionId": 677793,
        "domainName": null,
        "agentLicenseKey": "58C5D9FD5BC95FAA"
    }],
    "accountId": 5153184
}'
```

## 200 OK

```json
{
   "error": null,
    "data": {
        "retryMessages": {
            "10.100.193.54:55084": "Successfully initiated retry.",
            "10.100.193.54:55085": "Successfully initiated retry."
        },
        "failedRetries": {},
        "message": "2 of 2 automations submitted for retry.",
        "errors": [],
        "status": {}
    }
}
```

### Retry all ineligible automation

## cURL

```bash
curl --location --request POST 'https://caas.digicert.com/automationws/v1/automation/bulkretryautomationtask' \
--header 'X-DC-DEVKEY: {{api_key}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "retryAutomationTaskRequests": [{
        "ip": "10.100.196.228",
        "managementIp": "10.100.192.227",
        "port": 30005,
        "accountId": 5153184,
        "divisionId": 677793,
        "domainName": null,
        "virtualServerName": "/Zpartition/Per5",
        "sensorLicenseKey": "D08D879E57304FFB"
    }, {
        "ip": "10.100.196.228",
        "managementIp": "10.100.192.227",
        "port": 30013,
        "accountId": 5153184,
        "divisionId": 677793,
        "domainName": null,
        "virtualServerName": "/partition1/per13",
        "sensorLicenseKey": "D08D879E57304FFB"
    }],
    "accountId": 5153184
}'
```

## 200 OK

```json
{
   "error": null,
    "data": {
        "retryMessages": {},
        "failedRetries": {
            "10.100.196.228:30013": {
                "errors": [{
                    "errorCode": "1028",
                    "errorField": "10.100.196.228:30013",
                    "errorMessage": "Automated IP/Port is not eligible for retry."
                }],
                "status": {}
            },
            "10.100.196.228:30005": {
                "errors": [{
                    "errorCode": "1028",
                    "errorField": "10.100.196.228:30005",
                    "errorMessage": "Automated IP/Port is not eligible for retry."
                }],
                "status": {}
            }
        },
        "message": "0 of 2 automations submitted for retry.",
        "errors": [],
        "status": {}
    }
}
```

## 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>retryAutomationTaskRequests</td>
<td>required</td>
<td>object</td>
<td>Object container for retry automation details.</td>
</tr>
<tr>
<td>.. ip</td>
<td>required</td>
<td>integer</td>
<td>The port that you want to configure automation for.</td>
</tr>
<tr>
<td>.. port</td>
<td>required</td>
<td>integer</td>
<td>The port that you want to configure automation for.</td>
</tr>
<tr>
<td>accountId</td>
<td>required</td>
<td>string</td>
<td>Account ID.</td>
</tr>
<tr>
<td>divisionId</td>
<td>required</td>
<td>integer</td>
<td>Division ID.</td>
</tr>
<tr>
<td>.. domainName</td>
<td>optional<sup>*</sup></td>
<td>string</td>
<td>The domain name that you want to configure automation for.<br><sup>*</sup>Required only for SNI (having multiple profiles or certificates on same IP/Port) automation.</td>
</tr>
<tr>
<td>.. agentLicenseKey</td>
<td>optional<sup>*</sup></td>
<td>string</td>
<td>Agent license key.<br><sup>*</sup>Required for ACME automation agent flow.</td>
</tr>
<tr>
<td>.. virtualServerName</td>
<td>optional<sup>*</sup></td>
<td>string</td>
<td>Name of the virtual server to automate.<br><sup>*</sup>Required for agentless automation flow.<br><strong>Note:</strong> This parameter is not required for AWS load balancer.</td>
</tr>
<tr>
<td>.. sensorLicenseKey</td>
<td>optional<sup>*</sup></td>
<td>string</td>
<td>License key associated with the sensor.<br>Note: *Only returned if AGENTTYPE is selected as Agentless</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.<br><strong>Note:</strong> 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>.. retryMessages</td>
<td>object</td>
<td>Object container with retry information about the request.</td>
</tr>
<tr>
<td>.. failedRetries</td>
<td>object</td>
<td>Object container with failed retries about the request.</td>
</tr>
<tr>
<td>.. .. errors</td>
<td>array</td>
<td>List of objects with information about any errors that occurred while fetching the details.</td>
</tr>
<tr>
<td>.. .. .. errorField</td>
<td>string</td>
<td>The field that has error.</td>
</tr>
<tr>
<td>.. .. .. errorCode</td>
<td>string</td>
<td>Error code.</td>
</tr>
<tr>
<td>.. .. .. errorMessage</td>
<td>string</td>
<td>Error message.</td>
</tr>
<tr>
<td>.. message</td>
<td>string</td>
<td>Message with details about the retry task.</td>
</tr>
<tr>
<td>.. status</td>
<td>string</td>
<td>Status of the last check configuration request.<br>Possible values:<code>Failed</code>, <code>In progress</code>.</td>
</tr>
<tr>
<td>.. errors</td>
<td>array</td>
<td>List of errors, if any.</td>
</tr>
</tbody>
</table>