Skip to content

Renew a certificate

POST
/api/organizations/{organizationId}/certificates/{id}/renew

Queues an asynchronous ACME (re-)issuance for an auto_managed certificate and returns 202 Accepted with the dispatched jobId. Only auto_managed certificates can be renewed (400 otherwise). Returns 409 if the certificate is already renewing or a previous attempt is still in flight, to avoid hitting the CA rate limits. No request body is required.

Authorizations

ApiToken

Long-lived API token created via POST /api/api-tokens (returned once in plaintext).

Type
API Key (header: X-API-TOKEN)
or
JWT

JWT access token obtained via POST /api/auth/login. Send as: Authorization: Bearer .

Type
HTTP (bearer)

Parameters

Path Parameters

organizationId*

Organization identifier

Type
string
Required
id*

certificate identifier

Type
string
Required

Responses

certificate resource created

JSON
{
  
"@context": "string",
  
"@id": "string",
  
"@type": "string"
}

Playground

Authorization
Variables
Key
Value

Samples

Powered by VitePress OpenAPI