Revoke

Revokes a certificate

Revokes a certificate using the certificate serial number.

put/certificates/revoke/{serialNumber}

Request

  • Base URL: https://api.birdid.com.br (the document declares no server; this is the origin it was published from)
  • URL: https://api.birdid.com.br/certificates/revoke/{serialNumber}
  • Auth: none declared

Path parameters

serialNumberstring required
Example:2E4A7DD27F8B775E

Certificate serial number (hexadecimal)

Request body

issuer_dnstring required

Issuer Distinguished Name

reason'KEY_COMPROMISE' | 'CA_COMPROMISE' | 'AFFILIATION_CHANGED' | 'SUPERSEDED' | 'CESSATION_OF_OPERATION' | 'PRIVILEGES_WITHDRAWN' | 'AA_COMPROMISE' | 'REMOVE_FROM_CRL' | 'CERTIFICATE_HOLD' | 'UNSPECIFIED ' required

Revocation reason according to RFC 5280

Example request

{
  "issuer_dn": "UID=c-01ubfek040v2byazr,CN=ManagementCA,O=EJBCA Container Quickstart",
  "reason": "KEY_COMPROMISE"
}

Response

Certificate revoked successfully

issuer_dnstring
revocation_reasonstring
revocation_datestring date-time
serial_numberstring
messagestring
revokedboolean
invalidity_datestring date-time nullable

Example response

{
  "issuer_dn": "UID=c-01ubfek040v2byazr,CN=ManagementCA,O=EJBCA Container Quickstart",
  "revocation_reason": "KEY_COMPROMISE",
  "revocation_date": "2026-01-14T20:18:08Z",
  "serial_number": "2E4A7DD27F8B775E",
  "message": "Successfully revoked",
  "revoked": true,
  "detail": {
    "code": 1270,
    "status": "CRT_REVOKED_SUCCESS",
    "message": "Certificate successfully revoked."
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.