Delete Device
API version |
2.2 |
Last Update |
05/28/2015 |
Authentication |
YES |
Response Format |
JSON |
HTTP Method |
POST |
Rate limited |
YES |
Requests per rate limit |
10/min |
Use to delete a device on a given account
API URL
https://gears.opswat.com/o/api/v2.2/devices/:value/delete
Request Parameters
Key |
Datatype |
Parameter Type |
Required |
Description |
Default |
access_token |
string |
URL |
Yes |
access token which archived from OAuth authentication step |
|
value |
string |
URL |
Yes |
MAC Address or HWID of a device to be deleted |
|
opt |
int |
URL |
Optional |
0 – Only uninstall an agent on the device but keep the device data on Cloud 1 – Remove device data on Cloud as well as uninstall an agent on the device 2 - Archive Cloud database entry for the device and uninstall an agent on the device |
1 |
Response Parameters
Key |
Datatype |
Description |
result |
int |
0 - failure |
msg |
string |
Result details |
Example
Request Example
https://gears.opswat.com/o/api/v2.2/devices/0CQN6GRVGU2F1/delete?opt=0&access_token=TEST7P9ZMJ2LBF8AMOMJLFNPMMLO953AVQ4C9YFF52R61234
Response Example
{
"result": 1,
"msg": "Device has been deleted"
}
History
Version |
Link |
2.0 |