Skip to content

Delete a certificate

DELETE
/api/organizations/{organizationId}/certificates/{id}

Deletes a certificate. Rejected with 409 while any hostname still uses it - remove those hostnames (and their zones or redirects) first. When the certificate's domain has no hostnames and no managed DNS the domain is removed together with the certificate so its name becomes available again; when the domain still has managed DNS only the certificate is removed and the domain is kept.

Authorizations

ApiToken

Long-lived API token created via POST /api/api-tokens (returned once in plaintext). A token created with readOnly may only perform safe requests (GET, HEAD, OPTIONS); write requests are rejected on every endpoint.

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 deleted

Playground

Authorization
Variables
Key
Value

Samples

Powered by VitePress OpenAPI