Skip to content
regfish Docs

Revoke TLS certificate

POST /tls/certificate/{certificate_id}/revoke

Operation ID: RevokeCertificate

Revoke only the currently selected TLS certificate while keeping the order available for later reissue.

Path parameters

Section titled “Path parameters”
Name Type Required Description
certificate_id tlsCertificateId yes —

Request body

Section titled “Request body”

tlsCertificateRevokeRequest

Field Type Required Description
comment string no Optional provider comment for the revocation request.
revocation_reason tlsCertificateRevocationReason no Optional revocation reason forwarded to the CA. Defaults to unspecified when omitted.

Responses

Section titled “Responses”
Status Type Description
200 tlsCertificateResponse TLS certificate revocation accepted
400 Error Invalid request or revocation reason
401 Error Unauthorized
404 Error TLS certificate not found
409 Error The TLS certificate cannot be revoked in its current state
500 Error Unexpected error
502 Error Upstream TLS provider error

Response body

Section titled “Response body”
Field Type Required Description
success boolean yes Success indicator
code integer no Response/Error Code
response tlsCertificateResponse no —

Example

Section titled “Example”
Terminal-Fenster
curl -X POST "https://api.regfish.com/tls/certificate/<certificate_id>/revoke" \
  -H "x-api-key: $REGFISH_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "comment": "string",
    "revocation_reason": "cessationOfOperation"
  }'

Build a request

Section titled “Build a request”

Fill in values — the call below updates as you type. Nothing is sent: the API does not currently allow browser requests from this domain (CORS). The API key is not stored.