Cancel ACME contract

  2 minute read  

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

Use this endpoint to cancel an existing ACME contract.

Canceling an ACME contract permanently deactivates the contract and stops certificate issuance under it.

Canceling an ACME contract is irreversible. After cancellation, the ACME directory URL associated with the contract becomes inactive, and ACME clients configured to use the contract can no longer issue or renew certificates.

Cancellation behavior

Cancellation within the 30-day refund window

If the contract is canceled within 30 days of creation, the following actions occur:

  • The ACME directory URL associated with the contract becomes inactive.
  • Any ACME clients configured to use this contract can no longer issue or renew certificates.
  • SANs associated with the contract are released.
  • Eligible SANs are refunded on a per-SAN basis.

Cancellation outside the 30-day refund window

If the contract is older than 30 days, the endpoint returns 400 Bad Request.

To disable automatic renewal instead of canceling the contract, use the Partial update ACME contract endpoint to set auto_renew to false.

Example requests and responses

curl -X DELETE \
  https://www.digicert.com/partner-subscription/api/v1/acme/12345 \
  -H 'X-PARTNER-APIKEY: {{subaccount_partner_api_key}}'

204 No Content

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

URL path and query parameters

NameReq/OptTypeDescription
acme_contract_idrequiredintegerUnique identifier of the ACME contract to cancel.

Request parameters

This endpoint does not use request body parameters.

Response parameters

This endpoint does not return response parameters.