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

Name	Type	Required	Description
`certificate_id`	tlsCertificateId	yes	-

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

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

Field	Type	Required	Description
`success`	`boolean`	yes	Success indicator
`code`	`integer`	no	Response/Error Code
`response`	tlsCertificateResponse	no	-

Example

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

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.