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

JSON 
{
     "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).
Note:
  • 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/delete. Example: https://protectapi.cylance.com/devices/v2/delete
  • Method: HTTP/1.1 POST

Delete this text and replace it with your own content.