---
title: "Update ACME contract"
source_url: https://dev.digicert.com/partner-subscriptions-api/acme-contract-management/update-acme-contract.html
api_method: PUT
api_endpoint: "/partner-subscription/api/v1/acme/<acme_contract_id>"
api_url: "https://www.digicert.com/partner-subscription/api/v1/acme/{{acme_contract_id}}"
---

**PUT** `https://www.digicert.com/partner-subscription/api/v1/acme/{{acme_contract_id}}`

Use this endpoint to update an existing ACME contract.

This endpoint performs a full replacement of the ACME contract fields included in the request. For OV and EV contracts, you must include the `organization` object in the request body. You can also update the `auto_renew` setting for DV, OV, and EV contracts.


> **Info**
>
> Because this endpoint performs a full replacement, if you omit `auto_renew`, the corresponding value resets to `false`. To update only specific fields and preserve omitted values, use the PATCH endpoint.


> **Warning**
>
> Changing organization information rejects existing organization validation. Certificate issuance is blocked until revalidation is complete.
> <br><br>The following changes reject organization validation:
>
> - Organization name changes.
> - Address changes, including `address`, `address2`, `city`, `state`, `zip`, or `country`.
> - Other organization field changes, except contacts.
>
> The following changes do not reject organization validation:
>
> - Updating `organization_contact`.
> - Updating `technical_contact`.
> - Adding `verified_contacts` for EV contracts.
>
> If multiple ACME contracts on your account use the same organization details, changing the organization information invalidates validation for all affected contracts. All affected contracts must complete revalidation before certificates can be issued.
>
> Before updating organization information, confirm that the changes are necessary. Updating organization details can require revalidation for all ACME contracts that use the corresponding organization, which may delay certificate issuance across those contracts.


## Example requests and responses

**cURL - DV**

```bash
curl -X PUT \
  https://www.digicert.com/partner-subscription/api/v1/acme/12345 \
  -H 'Content-Type: application/json' \
  -H 'X-PARTNER-APIKEY: {{subaccount_partner_api_key}}' \
  -d '{
    "auto_renew": true
}'
```

**cURL - OV**

```bash
curl -X PUT \
  https://www.digicert.com/partner-subscription/api/v1/acme/12345 \
  -H 'Content-Type: application/json' \
  -H 'X-PARTNER-APIKEY: {{subaccount_partner_api_key}}' \
  -d '{
    "organization": {
      "name": "Example Corp",
      "assumed_name": "Example Corp"
      "address": "456 New St",
      "city": "San Francisco",
      "state": "CA",
      "zip": "94105",
      "country": "US",
      "telephone": "+1-555-0100",
      "contacts": [
        {
          "contact_type": "organization_contact",
          "first_name": "Jane",
          "last_name": "Smith",
          "email": "jane@example.com",
          "telephone": "+1-555-0200",
          "job_title": "Senior IT Director"
        },
        {
          "contact_type": "technical_contact",
          "first_name": "Alex",
          "last_name": "Taylor",
          "email": "alex.taylor@example.com",
          "telephone": "+1-555-0300",
          "job_title": "DevOps Lead"
        }
      ]
    },
    "auto_renew": true
}'
```

**cURL - EV**

```bash
curl -X PUT \
  https://www.digicert.com/partner-subscription/api/v1/acme/12346 \
  -H 'Content-Type: application/json' \
  -H 'X-PARTNER-APIKEY: {{subaccount_partner_api_key}}' \
  -d '{
    "organization": {
      "name": "Example Corp",
      "assumed_name": "Example Corp"
      "address": "456 New St",
      "city": "San Francisco",
      "state": "CA",
      "zip": "94105",
      "country": "US",
      "telephone": "+1-555-0100",
      "contacts": [
        {
          "contact_type": "organization_contact",
          "first_name": "Jane",
          "last_name": "Smith",
          "email": "jane@example.com",
          "telephone": "+1-555-0200",
          "job_title": "Senior IT Director"
        },
        {
          "contact_type": "technical_contact",
          "first_name": "Alex",
          "last_name": "Taylor",
          "email": "alex.taylor@example.com",
          "telephone": "+1-555-0300",
          "job_title": "DevOps Lead"
        },
        {
          "contact_type": "verified_contact",
          "first_name": "Alice",
          "last_name": "Johnson",
          "email": "alice.johnson@example.com",
          "telephone": "+1-555-0400",
          "job_title": "Chief Technology Officer"
        }
      ]
    },
    "auto_renew": true
}'
```


## 204 No Content

The ACME contract was updated successfully. The response does not include a body.


## URL path and query 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>acme_contract_id</td>
<td>required</td>
<td>integer</td>
<td>Unique identifier of the ACME contract to update.</td>
</tr>
</tbody>
</table>


## 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>organization</td>
<td>conditional</td>
<td>object</td>
<td>Object with information about the organization to associate with the ACME contract.  
<br><br><strong>Note:</strong> Organization updates apply to OV and EV contracts only.
<br><br>You can associate the contract with an existing organization or you can create a new organization. To create a new organization, include the organization details in the <code>organization</code> object.
<br><br>
<div style="border: 1px solid #d0d7de; padding: 12px; border-radius: 6px; background-color: #f6f8fa;"><strong>Duplicate organization check:</strong><br><br>When you submit a request with organization details, we check the organizations that already exist in your account to avoid creating a duplicate.<br><br>&bull; If we find <strong>one</strong> matching organization, we associate the request with that organization instead of creating a new one.<br>&bull; If we find <strong>two or more</strong> matching organizations, we associate the request with the oldest matching organization in your account instead of creating a new one.</div>
</td>
</tr>
<tr>
<td>.. assumed_name</td>
<td>optional</td>
<td>string</td>
<td>Assumed name or public name of the organization. Also called Doing Business As (DBA) name.</td>
</tr>
<tr>
<td>.. name</td>
<td>conditional</td>
<td>string</td>
<td>	Legal name of the organization. Required when creating a new organization or replacing organization details for an OV or EV contract.
<br><br><strong>Note:</strong> Updating the organization name rejects existing organization validation and requires revalidation.
</td>
</tr>
<tr>
<td>.. address</td>
<td>conditional</td>
<td>string</td>
<td>Address of the organization. Required when creating a new organization or replacing organization details for an OV or EV contract.
<br><br><strong>Note:</strong> Updating the organization address rejects existing organization validation and requires revalidation.</td>
</tr>
<tr>
<td>.. address2</td>
<td>optional</td>
<td>string</td>
<td>Second line of the organization's address. Use this field for additional address information, such as suite, floor, or unit.
<br><br><strong>Note:</strong> Updating this value rejects existing organization validation and requires revalidation.</td>
</tr>
<tr>
<td>.. city</td>
<td>conditional</td>
<td>string</td>
<td>City where the organization is located. Required when creating a new organization or replacing organization details for an OV or EV contract.
<br><br><strong>Note:</strong> Updating the city rejects existing organization validation and requires revalidation.</td>
</tr>
<tr>
<td>.. state</td>
<td>conditional</td>
<td>string</td>
<td>State or province where the organization is located. Required when creating a new organization or replacing organization details for an OV or EV contract.
<br><br><strong>Note:</strong> Updating the state or province rejects existing organization validation and requires revalidation.</td>
</tr>
<tr>
<td>.. zip</td>
<td>conditional</td>
<td>string</td>
<td>Postal or ZIP code where the organization is located. Required when creating a new organization or replacing organization details for an OV or EV contract.
<br><br><strong>Note:</strong> Updating the postal or ZIP code rejects existing organization validation and requires revalidation.</td>
</tr>
<tr>
<td>.. country</td>
<td>conditional</td>
<td>string</td>
<td>Two-letter country code where the organization is located. Required when creating a new organization or replacing organization details for an OV or EV contract.
<br><br><strong>Note:</strong> Updating the country rejects existing organization validation and requires revalidation.</td>
</tr>


<tr>
<td>.. organization_contact</td>
<td>conditional</td>
<td>object</td>
<td>Primary organization contact. 
<br><br>When creating a new organization, an <code>organization_contact</code> is required. If omitted, the organization is created and the authenticated user is used as the organization contact. 
<br><br><strong>Note:</strong> Required when adding <code>organization</code> object details for OV or EV products.</td>
</tr>
<tr>
<td>.. technical_contact</td>
<td>optional</td>
<td>object</td>
<td>Technical contact for the organization.
<br><br>A <code>technical_contact</code> is optional. If omitted, the organization is created with no technical contact.
<br><br><strong>Note:</strong> Optionally used when adding <code>organization</code> object details for OV or EV products.
</td>
</tr>
<tr>
<td>.. verified_contacts</td>
<td>conditional</td>
<td>array[object]</td>
<td>Verified contacts for EV contracts. 
<br><br><strong>Note:</strong> At least one <code>verified_contacts</code> is required when adding <code>organization</code> object details for EV products. Also, can be optionally used when adding <code>organization</code> object details for OV product. 
</td>
</tr>


<tr>
<tr>
<td>.. .. first_name</td>
<td>conditional</td>
<td>string</td>
<td>First name of the new organization, technical, or verified contact. 
<br><br> <strong>Note:</strong> Required for OV or EV products if you are creating a new contact. 
</td>
</tr>
<tr>
<td>.. .. last_name</td>
<td>conditional</td>
<td>string</td>
<td>Last name of the new organization, technical, or verified contact. <br><br> <strong>Note:</strong> Required for OV or EV products if you are creating a new contact. </td>
</tr>
<tr>
<td>.. .. email</td>
<td>conditional</td>
<td>string</td>
<td>Email address of the new organization, technical, or verified contact.<br><br> <strong>Note:</strong> Required for OV or EV products if you are creating a new contact. </td>
</tr>
<tr>
<td>.. .. telephone</td>
<td>conditional</td>
<td>string</td>
<td>Telephone number of the new organization, technical, or verified contact.<br><br> <strong>Note:</strong> Required for OV or EV products if you are creating a new contact. </td>
</tr>
<tr>
<td>.. .. job_title</td>
<td>conditional</td>
<td>string</td>
<td>Job title of the new organization, technical, or verified contact. 
<br><br> <strong>Note:</strong> Required for <code>verified_contact</code> contact type. Optional for OV or EV products while creating a new contact. </td>
</tr>


<tr>
<td>auto_renew</td>
<td>optional</td>
<td>boolean</td>
<td>Enable or disable auto-renewal. Because this endpoint performs a full replacement, if this parameter is omitted, it resets to <code>false</code>.</td>
</tr>
</tbody>
</table>


> **Info**
>
> For OV contracts, include an organization contact when required for the request. For EV contracts, include an organization contact and at least one verified contact. Technical contacts are optional.


> **Warning**
>
> When associating the request with an existing organization, DigiCert recommends using <code>organization.id</code>. To get organization IDs, use the List organizations endpoint. Deactivate unused organizations to prevent them from being assigned to new requests accidentally.


## Response parameters

This endpoint does not return response parameters.