Reissue, revoke and renew
Reissue and revoke
Section titled “Reissue and revoke”POST /api/v1/ssls/reissue
Section titled “POST /api/v1/ssls/reissue”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. |
DELETE /api/v1/ssls/revoke
Section titled “DELETE /api/v1/ssls/revoke”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. |
Renewal
Section titled “Renewal”POST /api/v1/ssls/renew
Section titled “POST /api/v1/ssls/renew”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
GET /api/v1/ssls/certificate— readsubscription.expiresAt.- From 30 days before that date — or after it —
POST /api/v1/ssls/renewwith the certificate’scertificateId. You are charged and get back the new certificate’scertificateId, statusWaitingForInstall. PUT /api/v1/ssls/configurewith the newcertificateId— 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.- Poll
check-statuswith the newcertificateIduntil it isActive. The old certificate then becomesRenewedby 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. |