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

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

Use this endpoint to partially update an existing ACME contract.

Unlike the PUT endpoint, this endpoint updates only the fields included in the request body. Omitted fields retain their current values. Use this endpoint to update `auto_renew` without changing organization data, or to update organization data without updating the entire ACME contract.


> **Info**
>
> Use the PATCH endpoint when you want to update specific ACME contract fields and preserve omitted values. For example, you can update only the <code>auto_renew</code> setting without resubmitting the <code>organization</code> object.


> **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 - Update auto-renew only**

```bash
curl -X PATCH \
  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 - Update organization contact only**

```bash
curl -X PATCH \
  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": {
      "organization_contact": {
        "first_name": "Jane",
        "last_name": "Smith",
        "email": "jane@example.com",
        "telephone": "+1-555-0200",
        "job_title": "Senior IT Director"
      }
    }
}'
```

**cURL - Update organization and auto-renew**

```bash
curl -X PATCH \
  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,
    "organization": {
      "name": "Example Corp",
      "address": "456 New St",
      "city": "San Francisco",
      "state": "CA",
      "zip": "94105",
      "country": "US",
      "organization_contact": {
        "first_name": "Jane",
        "last_name": "Smith",
        "email": "jane@example.com",
        "telephone": "+1-555-0200"
      }
    }
}'
```


## 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 partially 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>auto_renew</td>
<td>optional</td>
<td>boolean</td>
<td>Enable or disable auto-renewal for the ACME contract. If omitted, the current <code>auto_renew</code> value is preserved.
<br><br>Use this endpoint to change the auto-renewal setting after the ACME contract is created. To configure renewal behavior during subscription creation, set `auto_renew` while creating an ACME contract.
</td>
</tr>
<tr>
<td>organization</td>
<td>optional</td>
<td>object</td>
<td>Object with organization details to update for the ACME contract. Only the organization fields included in the request are updated; omitted organization fields retain their current values.
<br><br><strong>Note:</strong> Organization updates apply to OV and EV contracts only.</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.
<br><br><strong>Note:</strong> Updating this value may require organization revalidation if it changes the organization information used for validation.</td>
</tr>
<tr>
<td>.. name</td>
<td>optional</td>
<td>string</td>
<td>Legal name of the organization.
<br><br><strong>Note:</strong> Updating the organization name rejects existing organization validation and requires revalidation.</td>
</tr>
<tr>
<td>.. address</td>
<td>optional</td>
<td>string</td>
<td>Address of the organization.
<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. 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>optional</td>
<td>string</td>
<td>City where the organization is located.
<br><br><strong>Note:</strong> Updating the city rejects existing organization validation and requires revalidation.</td>
</tr>
<tr>
<td>.. state</td>
<td>optional</td>
<td>string</td>
<td>State or province where the organization is located. Use the full name instead of an abbreviation.
<br><br><strong>Note:</strong> Updating the state or province rejects existing organization validation and requires revalidation.</td>
</tr>
<tr>
<td>.. zip</td>
<td>optional</td>
<td>string</td>
<td>Postal or ZIP code where the organization is located.
<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>optional</td>
<td>string</td>
<td>Two-letter country code where the organization is located.
<br><br><strong>Note:</strong> Updating the country rejects existing organization validation and requires revalidation.</td>
</tr>
<tr>
<td>.. telephone</td>
<td>optional</td>
<td>string</td>
<td>Organization phone number.</td>
</tr>
<tr>
<td>.. organization_contact</td>
<td>optional</td>
<td>object</td>
<td>Primary organization contact for the organization. Include this object to add or replace the organization contact.
<br><br><strong>Note:</strong> Updating the organization contact does not reject existing organization validation.</td>
</tr>
<tr>
<td>.. technical_contact</td>
<td>optional</td>
<td>object</td>
<td>Technical contact for the organization. Include this object to add or replace the technical contact.
<br><br><strong>Note:</strong> Updating the technical contact does not reject existing organization validation.</td>
</tr>
<tr>
<td>.. verified_contacts</td>
<td>optional</td>
<td>array[object]</td>
<td>Verified contacts for EV contracts. Include this array to add or replace verified contacts.
<br><br><strong>Note:</strong> Adding verified contacts for EV contracts does not reject existing organization validation.</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 when adding or replacing a 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 when adding or replacing a 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 when adding or replacing a 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 when adding or replacing a 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 when adding or replacing a verified contact for EV contracts. Optional for organization and technical contacts.</td>
</tr>
</tbody>
</table>


> **Info**
>
> For OV contracts, organization contacts and technical contacts can be updated with the <code>organization.organization_contact</code> and <code>organization.technical_contact</code> objects. For EV contracts, verified contacts can be updated with the <code>organization.verified_contacts</code> array. Technical contacts are optional.


## Response parameters

This endpoint does not return response parameters.