Delete Devices

Delete one or more devices from a tenant. This asynchronous operation can take up to two hours to delete the devices. If a callback URL is provided, the callback occurs 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

For more information, see Response status codes.

Request JSON schema

Field Name Description

callback_url

The URL of the callback upon completion (optional).

Note: If you are not using a callback URL, leave it out of the request. An empty callback URL results in an error message.

device_ids

The unique identifiers of the devices to be deleted:

  • All device IDs should be well formed GUIDs. Non-conforming values are removed from the request.
  • The maximum number of device IDs per request is 20.

Response JSON schema

Field Name Description

request_id

The unique identifier for the deletion request.
Not all clients support sending a DELETE request. This example uses a POST request instead.
  • Service Endpoint: /devices/v2/delete. Example: https://protectapi.cylance.com/devices/v2/delete
  • Method: HTTP/1.1 POST