DKBSignDocs

API reference

POSTRequires Bearer token

Revoke a certificate

/api/v1/companies/{company}/certificates/{certificate}/revoke

Company-admin. Optional RFC 5280 reason.

Path parameters

FieldTypeDescription
company
Required
stringPath parameter company.
certificate
Required
stringPath parameter certificate.

Query parameters

This endpoint has no query parameters.

Request body

FieldTypeDescription
reason
stringRFC 5280 reason: UNSPECIFIED, KEYCOMPROMISE, CACOMPROMISE, AFFILIATIONCHANGED, SUPERSEDED, CESSATIONOFOPERATION, CERTIFICATEHOLD, REMOVEFROMCRL, PRIVILEGEWITHDRAWN, AACOMPROMISE.
e.g. "UNSPECIFIED"

Responses

StatusMeaning
200Certificate revoked
401Missing or invalid Bearer token.

Request

curl
curl -X POST 'https://api.dkbsigns.com/api/v1/companies/company/certificates/certificate/revoke' \
  -H 'Authorization: Bearer $DKBSIGN_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{"reason":"UNSPECIFIED"}'

Response 200

json
{
  "status": "success",
  "message": "Certificate revoked"
}