v1

latestOpenAPI 3.1.02026-07-245531,0212.1 MB
Endpoints

Delete a device

Deletes a device in the system. When you delete a device:

  1. All the device data (restore points) is deleted.
  2. You can roll back the deleted device from Rollback Actions until the rollback window lapses.
  3. After the rollback window lapses, the device will be deleted permanently. For more information, see <a href=https://docs.druva.com/Cyber_Resilience/Rollback_Actions>Rollback Actions</a>.
delete/endpoints/v1/devices/{deviceID}

Path parameters

deviceIDinteger required

The unique ID of device in inSync. Get the ID of a device using the ‘List all devices’ API.

Request body

deletionReasonstring

Specify the reason for device deletion, (the character limit of reason is between 10-150) . This capability will help prevent accidental deletions. If no reason is specified, the default reason i.e. <b>API initiated Device Deletion</b> will be displayed.

Example request

{
  "deletionReason": "Inactive device"
}

Response

OK

{"stackTrail":"paths:/endpoints/v1/devices/{deviceID}:delete:responses:200:content:application/json:schema","oasType":"schema","type":"unknown"}