Use this endpoint to change the setting for when you receive notification emails about vulnerability assessments for an order.
Replace {{order_id}}
in the URL with the ID of the order. To get the ID values for orders in your account, use the List orders endpoint.
curl-X PUT \
https://www.digicert.com/services/v2/vulnerability-assessment/{{order_id}}/notification-settings \
-H 'Content-Type: application/json' \
-H 'X-DC-DEVKEY: {{api_key}}' \
-d '{
"setting": "always_notify"
}'
import requests
url = "https://www.digicert.com/services/v2/vulnerability-assessment/{{order_id}}/notification-settings"
payload = "{\n\t\"setting\": \"always_notify\"\n}"
headers = {
'Content-Type': 'application/json',
'X-DC-DEVKEY': '{{api_key}}'
}
response = requests.request("PUT", url, headers=headers, data = payload)
print(response.text.encode('utf8'))
package main
import (
"fmt"
"strings"
"net/http"
"io/ioutil"
)
func main() {
url := "https://www.digicert.com/services/v2/vulnerability-assessment/{{order_id}}/notification-settings"
method := "PUT"
payload := strings.NewReader("{\n \"setting\": \"always_notify\"\n}")
client := &http.Client {
}
req, err := http.NewRequest(method, url, payload)
if err != nil {
fmt.Println(err)
}
req.Header.Add("Content-Type", "application/json")
req.Header.Add("X-DC-DEVKEY", "{{api_key}}")
res, err := client.Do(req)
defer res.Body.Close()
body, err := ioutil.ReadAll(res.Body)
fmt.Println(string(body))
}
var request = require('request');
var options = {
'method': 'PUT',
'url': 'https://www.digicert.com/services/v2/vulnerability-assessment/{{order_id}}/notification-settings',
'headers': {
'Content-Type': 'application/json',
'X-DC-DEVKEY': '{{api_key}}'
},
body: JSON.stringify({"setting":"always_notify"})
};
request(options, function (error, response) {
if (error) throw new Error(error);
console.log(response.body);
});
// empty
{
"errors": [
{
"code": "not_found|route",
"message": "The specified route was not found."
}
]
}
{
"errors": [
{
"code": "access_denied",
"message": "You do not have permission to manage this request."
}
]
}
{
"errors": [
{
"code": "va_not_eligible_order",
"message": "Invalid order status. Order must be issued, not revoked, expired, or pending."
}
]
}
{
"errors": [
{
"code": "va_not_eligible_product",
"message": "Invalid certificate type. Vulnerability assessment is only available for Secure Site EV and Secure Site Pro certificates."
}
]
}
Name | Opt/Req | Type | Description |
---|---|---|---|
setting | required | string |
Sets when you receive notification emails. Allowed values (case sensitive, lowercase):
|