All revocation requests must be approved by an administrator before DigiCert will revoke the certificate. This approval step is required and cannot be skipped.
Use this endpoint to submit a request to revoke a single certificate on the order.
If you want to submit a request to revoke the entire order, use the Revoke order certificates endpoint.
Certificates with a pending reissue order cannot be revoked. To revoke a certificate with a pending reissue, either cancel the reissue request or revoke the certificate after the reissue is complete.
When you revoke a certificate on an order with only a single certificate:
If you do not plan to reissue a certificate for the order, use the Revoke order certificates endpoint to submit a request to revoke the order.
curl -X PUT \
'https://www.digicert.com/services/v2/certificate/{{certificate_id}}/revoke' \
-H 'Content-Type: application/json' \
-H 'X-DC-DEVKEY: {{api_key}}' \
-d '{
"comments": "I no longer need this cert."
}'import requests
url = "https://www.digicert.com/services/v2/certificate/{{certificate_id}}/revoke"
payload = "{\n \"comments\": \"I no longer need this cert.\"\n}"
headers = {
'X-DC-DEVKEY': "{{api_key}}",
'Content-Type': "application/json"
}
response = requests.request("PUT", url, data=payload, headers=headers)
print(response.text)package main
import (
"fmt"
"strings"
"net/http"
"io/ioutil"
)
func main() {
url := "https://www.digicert.com/services/v2/certificate/{{certificate_id}}/revoke"
payload := strings.NewReader("{\n \"comments\": \"I no longer need this cert.\"\n}")
req, _ := http.NewRequest("PUT", url, payload)
req.Header.Add("X-DC-DEVKEY", "{{api_key}}")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := ioutil.ReadAll(res.Body)
fmt.Println(res)
fmt.Println(string(body))
}var request = require("request");
var options = { method: 'PUT',
url: 'https://www.digicert.com/services/v2/certificate/{{certificate_id}}/revoke',
headers:
{ 'Content-Type': 'application/json',
'X-DC-DEVKEY': '{{api_key}}' },
body: { comments: 'I no longer need this cert.' },
json: true };
request(options, function (error, response, body) {
if (error) throw new Error(error);
console.log(body);
});{
"id": 1,
"date": "2016-02-10T17:06:15+00:00",
"type": "revoke",
"status": "pending",
"requester": {
"id": 14,
"first_name": "John",
"last_name": "Smith",
"email": "john.smith@digicert.com"
},
"comments": "I no longer need this cert."
}| Name | Req/Opt | Type | Description |
|---|---|---|---|
| comments | optional | string | Message about the revoke request. |
| Name | Type | Description |
|---|---|---|
| id | int | Request ID. |
| date | string |
Timestamp of when the request was submitted. Format: UTC timezone and ISO 8601 date |
| type | string |
Request type. Possible values: revoke
|
| status | string |
Status of the revoke request. Possible values: submitted, pending, approved, rejected
|
| requester | object |
Details about the user that placed the request. See Structures – User details object. |
| comments | string | Message about the revoke request. |