Use this endpoint to revoke a certificate.
curl --request PUT 'https://one.digicert.com/iot/api/v1/certificate/b0484486-a56b-4e37-a5de-b717c59163fa/revoke' \
--header 'x-api-key: {{api_key}}' \
--header 'Content-Type: application/json' \
--data-raw '{
"reason": "key_compromise",
"revocation_date": "2020-05-18T15:35:00Z",
"comments": "revocation comment"
}'
// Certificate successfully revoked, no content returned
{
"errors": [
{
"code": "entity_not_found",
"message": "Certificate with id da39ba51-b556-4a1a-bd78-75e46fa86be7 does not exist"
}
]
}
Name | Req/Opt | Description |
---|---|---|
certificate_id | required | ID of certificate to revoke. |
Name | Req/Opt | Type | Description |
---|---|---|---|
reason | required | string |
Reason for revocation. Allowed values: See Revocation reasons table below. |
revocation_date | optional | string |
Specific day the certificate is considered revoked. Signing or other activities performed with the certificate before the revocation date are still considered valid. Default: Certificate is revoked entirely from its validity start date. |
comments | optional | string | User-entered notes. |
Revocation reason ID |
---|
unspecified |
key_compromise |
affiliation_changed |
suspended |
cessation_of_operation |
certificate_hold |
privilege_withdrawn |
aa_compromise |