Void sensor

less than a minute

POST https://daas.digicert.com/apicontroller/v1/sensor/void

Use this endpoint to void the sensor permanently.

Example requests and responses

cURL

curl --location --request POST 'https://daas.digicert.com/apicontroller/v1/sensor/void' \
--header 'X-DC-DEVKEY: {{api_key}}' \
--header 'Content-Type: application/json' \
--data-raw '{"accountId":5153184,"divisionIds":[677793],"licenseKey":[{{license_key}}],"reason":"No longer in use"}'

200 OK

[
    {
        "error": null,
        "data": {
            "id": "984A6B3F786A3C14",
            "message": "Sensor Voided Successfully"
        }
    }
]

Request parameters

Name	Reqd/Opt.	Type	Description
accountId	required	string	Account ID.
divisionId	required	integer	Division ID.
licenseKey	required	string	License key of the sensor to void. Supports bulk void by providing comma-separated license keys.
reason	optional	string	Reason for voiding the sensor.

Response parameters

Name	Type	Description
error	object	Includes the error code, if any.
data	object	Object container for response.
.. id	string	License key of the terminated sensor.
.. message	string	Message with additional information about the request.