APIs & SDKs/shadw REST API/Renew the SSL certificate

Renew the SSL certificate

POSThttps://api.shadw.cloud/v1/domains/{domain}/ssl/renew

Request reissue of the domain's free managed Let's Encrypt certificate. Issuance runs in the background; the response is the domain's current certificate block (renewal is pending until a certificate is installed, then auto).

Authentication

AuthorizationbearerToken

A platform API key (hive_…, created under Settings → API Keys) or a JWT of at most 1 hour from POST /v1/token, which is server-only once HIVE_JWT_SECRET is set. An API key scopes the request to the team it was created under.

Path parameters

domainstringRequired

The domain name.

ts

const response = await fetch('https://api.shadw.cloud/v1/domains/{domain}/ssl/renew', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY', // hive_… (Settings → API Keys)
  },
});

const data = await response.json();
console.log(data);

Response

json

{ "id": "", "cns": [], "renewal": "pending", "issued_ms": 0, "expires_ms": 0, "provider": "OpenEdge (Let's Encrypt)" }