Get the PDF

Delete Devices

Delete one or more devices from a tenant. This is an asynchronous operation and could take up to two hours to delete the devices. If a callback URL is provided, the callback will occur when deletion is complete.

Service endpoint	/devices/v2
Optional query string parameters	—
Example	https://protectapi.cylance.com/devices/v2
Method	HTTP/1.1 DELETE
Request headers	Accept: application/json Authorization: Bearer with the device:delete scope encoded. Content-Type: application/json

Request

{
     "device_ids":
     [
         "e378dacb-9324-453a-b8c6-5a8406952195",
         "a358daac-2394-653a-a9c2-8a8408972163",
         "b248cbba-6367-821b-a7a2-4a3200972163"
     ],
     "callback_url": "https://exampleurl.com"
}

Response

Please see the Response status codes for more information.

Request JSON schema

Field Name	Description
callback_url	This is the URL of the callback upon completion (optional). If you are not using a callback URL, then leave it out of the request. An empty callback URL results in an error message. The URL used in the above Request is just an example. Replace it with your own callback URL.
device_ids	These are the unique identifiers for the devices to be deleted: All device IDs should be well formed GUIDs. Non-conforming values will be removed from the request. The maximum number of device IDs per request is 20.

Response JSON schema

Field Name	Description
request_id	This is the unique identifier for the deletion request.

Not all clients support sending a DELETE request. For this instance, use the following POST instead.

Service Endpoint: /devices/v2/deleteExample: https://protectapi.cylance.com/devices/v2/delete

Method: HTTP/1.1 POST

Delete this text and replace it with your own content.

Section:

Device API