Skip to content

Reissue, revoke and renew

Re-issues an active certificate with a new key pair or a new approver. Free on most packages. The validity period is not extended.

When you need this

  • The private key was lost or compromised.
  • The server is being rebuilt and the key cannot be recovered.
  • The approver e-mail address needs changing.

Request — let us generate a new key

{
"certificateId": "5e8c2a71-4b93-4f06-ae25-1d7f9c3b8042"
}

Request — bring your own new CSR

{
"certificateId": "5e8c2a71-4b93-4f06-ae25-1d7f9c3b8042",
"csr": "-----BEGIN CERTIFICATE REQUEST-----\n...\n-----END CERTIFICATE REQUEST-----",
"privateKey": "-----BEGIN PRIVATE KEY-----\n...\n-----END PRIVATE KEY-----",
"approverMail": "webmaster@apiname.com"
}
Field Required Notes
certificateId required The certificate to reissue.
approverMail optional A new approver. Omit to keep the current one.
csr optional Your new CSR. Omit it and we generate a new CSR and private key and return both.
privateKey optional The key for your csr, only if you want us to store it.

Response — 200, when you omitted the CSR

{
"success": true,
"message": "Reissue request submitted",
"certificateId": "5e8c2a71-4b93-4f06-ae25-1d7f9c3b8042",
"status": "WaitingForValidation",
"dcvDetails": "{\"MD5\":\"...\",\"SHA1\":\"...\",\"UniqueValue\":\"...\"}",
"csr": "-----BEGIN CERTIFICATE REQUEST-----\nMIICvDCCAaQCAQAwdzEL...\n-----END CERTIFICATE REQUEST-----",
"privateKey": "-----BEGIN PRIVATE KEY-----\nMIIEvQIBADANBgkqhki...\n-----END PRIVATE KEY-----"
}

After reissuing you go through validation again: publish the new dcvDetails record or have the approver click the new e-mail, then poll check-status.

Errors

Code Meaning and fix
Ssl:10026 Unknown certificateId, or it is not yours.
Ssl:10006 Reissue is not supported for this certificate.
Ssl:10008 The certificate must be Active. You cannot reissue one that is still validating.
Ssl:10055 The subscription has ended. Reissue is not possible — renew the certificate.
Ssl:10075 This package is managed by our technical team. Open a support ticket.
Ssl:10007 The CA failed to process the reissue. Retry, or open a ticket.
Ssl:10004 / Ssl:10040 Your supplied CSR is invalid or its name does not match.

Revokes the certificate. Its status becomes Cancelled.

Request

DELETE /api/v1/ssls/revoke?certificateId=5e8c2a71-4b93-4f06-ae25-1d7f9c3b8042
Parameter Required Notes
certificateId required In the query string. A request body is not read.

Errors

Code Meaning and fix
Ssl:10026 Unknown certificateId, or it is not yours.
Ssl:10027 The status does not allow revoking — already cancelled, or not yet configured.
Ssl:10049 The revoke failed. Note: this code is shared with a CA connectivity error — read the message to tell which.
Ssl:10075 Package managed by our technical team. Open a support ticket.

Renews a certificate: opens a new one-year certificate linked to the one you send, and debits the renewal price. Package and domain are taken from the existing certificate. The new certificate is configured from scratch, like a new purchase.

The routine

  1. GET /api/v1/ssls/certificate — read subscription.expiresAt.
  2. From 30 days before that date — or after it — POST /api/v1/ssls/renew with the certificate’s certificateId. You are charged and get back the new certificate’s certificateId, status WaitingForInstall.
  3. PUT /api/v1/ssls/configure with the new certificateId — new CSR, contact and validation method. The new year begins here, not at the old expiry. The 15-day configuration window applies, as for any purchase.
  4. Poll check-status with the new certificateId until it is Active. The old certificate then becomes Renewed by itself. It stays technically valid until its own expiry, so there is no gap.

Request

{
"certificateId": "5e8c2a71-4b93-4f06-ae25-1d7f9c3b8042"
}
Field Required Notes
certificateId required The certificate to renew.

There is no packageCode and no period: the package is that of the existing certificate — it can be renewed even if the package is no longer on sale — and the term is always one year.

Response — 200

{
"success": true,
"message": "SSL certificate renewal initialized successfully. Waiting for installation.",
"certificateId": "9b41d0e6-7c2a-4f58-8e13-6a5f2d9c7b20",
"status": "WaitingForInstall",
"dcvDetails": null,
"csr": null,
"privateKey": null
}

Who can renew

  • A configured certificate that is not cancelled and not already Renewed.
  • At most 30 days before subscription.expiresAt, or any time after it.
  • Once. A renewal that was cancelled — for example because its configuration window lapsed — does not count, so you can renew again.

Errors

Code Meaning and fix
Ssl:10026 Unknown certificateId, or it is not yours.
Ssl:10057 Too early. The message tells you the date renewal opens.
Ssl:10058 Already renewed — the renewal is in your certificate list.
Ssl:10059 Not renewable. Only configured certificates that are not cancelled or already renewed can be renewed.
Ssl:10003 The certificate’s package no longer exists. Open a ticket.
Ssl:10046 No renewal price is configured for this package. Open a ticket.
Ssl:10045 Insufficient balance. data gives the shortfall.
Ssl:10047 Your balance is suspended.