v1

latestSwagger 2.02026-07-132946124.7 KB

Renew active certificate

Renewal is the process by which the validity of a certificate is extended. Renewal is only available 60 days prior to expiration of the previous certificate and 30 days after the expiration of the previous certificate. The renewal supports modifying a set of the original certificate order information. Once a request is validated and approved, the certificate will be issued with extended validity. Since subject alternative names can be removed during a renewal, we require that you provide the subject alternative names you expect in the renewed certificate. New names added to a certificate that do not share the base domain of the common name may take additional time to validate. </p>

post/v1/certificates/{certificateId}/renew

Path parameters

certificateIdstring required

Certificate id to renew

Request body

callbackUrlstring

Required if client would like to receive stateful actions via callback during certificate lifecyle

commonNamestring

The common name of certificate to be secured

csrstring

Certificate Signing Request.

periodinteger

Number of years for certificate validity period, if different from previous certificate

rootType'GODADDY_SHA_1' | 'GODADDY_SHA_2' | 'STARFIELD_SHA_1' | 'STARFIELD_SHA_2'

Root Type. Depending on certificate expiration date, SHA_1 not be allowed. Will default to SHA_2 if expiration date exceeds sha1 allowed date

subjectAlternativeNamesstring[]

Only used for UCC products. An array of subject alternative names to include in certificate. Not including a subject alternative name that was in the previous certificate will remove it from the renewed certificate.

Response

Renew request created