Replace

Use this endpoint to replace an existing certificate identified by its certId.

Send a new CSR, and the API returns a new certificate ID you can use to download the replacement certificate once it’s issued.

Replacing a certificate creates a new certificate with the original certificate's validity period. It is not billable.

You can only replace public SSL certificates.

Note: This page covers the essentials. For full parameters, examples, and response schema, see Replace certificate (API Reference)

Request

• Authorization: Bearer <access_token> (see Authentication and Create Access Token).
• Method: POST.
• Base URL: see Base URL and Variables.
• Path: /api/v1/certificates/{certId}/replace.
• Path parameter:
  • certId: the ID of the certificate you want to replace.
• Body (JSON):
  • csr: Required. Single-line Base64 PKCS#10 (no BEGIN/END lines).
  • For other parameters, see SSLRENEWREQUEST.
  
  

Response

• On success, returns a JSON payload containing a new certId for the replacement certificate.