Edit domains on a pending order or reissue
PUT https://www.digicert.com/services/v2/order/certificate/{{order_id}}/dns-names
Use this endpoint to edit the domains (common_name
and dns_names
) on a pending TLS/SSL certificate order or reissue. This is useful when you want to change which domains a certificate will secure without submitting a new certificate order or reissue request.
Usage and limitations
Editing domains does not change the price of the certificate order.
You can only replace a domain/IP address with another domain/IP address and a wildcard domain with another wildcard domain.
The total number of domains cannot exceed the number of domains on the original certificate request.
You can add domains back to the order for free, up to the original amount purchased, the next time you reissue the certificate.
To edit domains, the authenticated user must be an admin or manager.
Danger
This endpoint is destructive to the certificate.dns_names
array. Omitting the certificate.dns_names
array from your request replaces the list of dns_names
on the pending order or reissue with a new list that only includes the common_name
value.
Validate added domains
Domains you add to a pending order or reissue are automatically submitted for validation using the same DCV method as the original order or reissue request. If the order is for an OV or EV TLS/SSL certificate, new domains submitted for validation are also added to your CertCentral account.
After adding or replacing domains:
Use the Validation status API endpoint to get the validation status of each added domain.
Complete domain control validation (DCV) for any unapproved domains.
Learn more:
Example requests and responses
Path parameters
Name | Type | Req/Opt | Description |
---|---|---|---|
order_id | number | required | Order ID. To edit domains, the order must have a |
Request parameters
Name | Type | Req/Opt | Description |
---|---|---|---|
certificate | object | required | Certificate object. |
.. common_name | string | optional | Certificate common name. If not provided, the common name is not changed. Note: You cannot change the common name if your account settings require the common name in your request to match the CSR. |
.. dns_names | array of strings | optional | Updated list of domains for the order. You can omit the Important: This list overwrites the domains that already exist on the pending order or reissue. Make sure it includes any domains or IP addresses you don’t want to remove. To get a list of domains on a pending order or reissue, use the Validation status API endpoint. |