Update ACME contract

6 minute read

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.

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.

Changing organization information rejects existing organization validation. Certificate issuance is blocked until revalidation is complete.

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 -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 -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 -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

Name	Req/Opt	Type	Description
acme_contract_id	required	integer	Unique identifier of the ACME contract to update.

Request parameters

Name	Req/Opt	Type	Description
organization	conditional	object	Object with information about the organization to associate with the ACME contract. Note: Organization updates apply to OV and EV contracts only. 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 `organization` object. Duplicate organization check: When you submit a request with organization details, we check the organizations that already exist in your account to avoid creating a duplicate. • If we find one matching organization, we associate the request with that organization instead of creating a new one. • If we find two or more matching organizations, we associate the request with the oldest matching organization in your account instead of creating a new one.
.. assumed_name	optional	string	Assumed name or public name of the organization. Also called Doing Business As (DBA) name.
.. name	conditional	string	Legal name of the organization. Required when creating a new organization or replacing organization details for an OV or EV contract. Note: Updating the organization name rejects existing organization validation and requires revalidation.
.. address	conditional	string	Address of the organization. Required when creating a new organization or replacing organization details for an OV or EV contract. Note: Updating the organization address rejects existing organization validation and requires revalidation.
.. address2	optional	string	Second line of the organization's address. Use this field for additional address information, such as suite, floor, or unit. Note: Updating this value rejects existing organization validation and requires revalidation.
.. city	conditional	string	City where the organization is located. Required when creating a new organization or replacing organization details for an OV or EV contract. Note: Updating the city rejects existing organization validation and requires revalidation.
.. state	conditional	string	State or province where the organization is located. Required when creating a new organization or replacing organization details for an OV or EV contract. Note: Updating the state or province rejects existing organization validation and requires revalidation.
.. zip	conditional	string	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. Note: Updating the postal or ZIP code rejects existing organization validation and requires revalidation.
.. country	conditional	string	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. Note: Updating the country rejects existing organization validation and requires revalidation.
.. organization_contact	conditional	object	Primary organization contact. When creating a new organization, an `organization_contact` is required. If omitted, the organization is created and the authenticated user is used as the organization contact. Note: Required when adding `organization` object details for OV or EV products.
.. technical_contact	optional	object	Technical contact for the organization. A `technical_contact` is optional. If omitted, the organization is created with no technical contact. Note: Optionally used when adding `organization` object details for OV or EV products.
.. verified_contacts	conditional	array[object]	Verified contacts for EV contracts. Note: At least one `verified_contacts` is required when adding `organization` object details for EV products. Also, can be optionally used when adding `organization` object details for OV product.
.. .. first_name	conditional	string	First name of the new organization, technical, or verified contact. Note: Required for OV or EV products if you are creating a new contact.
.. .. last_name	conditional	string	Last name of the new organization, technical, or verified contact. Note: Required for OV or EV products if you are creating a new contact.
.. .. email	conditional	string	Email address of the new organization, technical, or verified contact. Note: Required for OV or EV products if you are creating a new contact.
.. .. telephone	conditional	string	Telephone number of the new organization, technical, or verified contact. Note: Required for OV or EV products if you are creating a new contact.
.. .. job_title	conditional	string	Job title of the new organization, technical, or verified contact. Note: Required for `verified_contact` contact type. Optional for OV or EV products while creating a new contact.
auto_renew	optional	boolean	Enable or disable auto-renewal. Because this endpoint performs a full replacement, if this parameter is omitted, it resets to `false`.

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.

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