Need help? Call Live Support at +31 (0) 38 453 07 59

Attention! You're currently using the OT&E environment.

Renew

Used to renew a certificate that is about to expire

Deprecated This API call is deprecated. You are strongly advised not to use this call anymore. Instead, switch to the Renew Certificate call, which provides the functionality of this call, and more.
  • POSTMethod
  • /v2/customers/{customer}/certificates/certificateId/renewURL
  • application/jsonContent-Type
URL fields
Name Type Description Restrictions
certificateId Integer The ID of the certificate
Request parameters
Name Type Required / Optional Description Restrictions
quote Boolean Optional If true, validate the request and request a quote for the action
Request content fields
Name Type Required / Optional Description Restrictions
product Enum Optional The product defines the type of certificate to create

Possible values:

  • ssl_comodo_positive: PositiveSSL
  • ssl_comodo_positive_wc: PositiveSSL wildcard
  • ssl_comodo_instant: InstantSSL
  • ssl_comodo_instant_wc: InstantSSL wildcard
  • ssl_comodo_ev: Extended validation
period Integer Required The validity period of the certificate in years

Possible values:

  • 1
  • 2
  • 3
  • 4
  • 5
csr String Optional A valid Certificate Signing Request
validationMethod Enum Required The validation type used for the certificate request

Possible values:

  • Provider specific. Refer to provider metadata for possible values:
properties Map <String, String> Required Provider specific properties. Look here for an overview of possible properties.
billables List < billables > Optional Acknowledgment of billables for this request
billables
Name Type Required / Optional Description Restrictions
product String Required The product
action Enum Required The action

Possible values:

  • CREATE
  • REQUEST
  • TRANSFER
  • RENEW
  • RESTORE
  • TRANSFER_RESTORE
  • UPDATE
  • REGISTRANT_CHANGE
  • LOCAL_CONTACT
  • NEGATIVE_MARKUP
  • PRIVACY_PROTECT
  • EXTRA_WILDCARD
  • EXTRA_DOMAIN
  • REGISTRY_LOCK
quantity Integer Optional The maximum quantity, default 1

Successful request

Request accepted, pending result
  • 202 AcceptedHTTP Status

Failed requests

Besides the generic errors these specific error responses can be expected.

Error responses
Type Status Description
BillableAcknowledgmentNeededException 400 Bad Request
URL fields
The ID of the certificate
Request parameters
If true, validate the request and request a quote for the action
Request parameters
The product defines the type of certificate to create
The validity period of the certificate in years
A valid Certificate Signing Request
The validation type used for the certificate request
Provider properties

Provider specific properties. Look here for an overview of possible properties.

billables
The product
The action
The maximum quantity, default 1
Request

POST /v2/customers/{customer}/certificates/certificateId/renew
Content-Type: application/json 

{}
Response