Skip Navigation

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" ], "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.