Delete Devices v2.0
| API version | 2.0 |
|---|---|
| Last Update | 08/19/2014 |
| Authentication | YES |
| Response Format | JSON |
| HTTP Method | POST |
| Rate limited | YES |
| Requests per rate limit | 10/min |
Use to delete devices on an account
API URL
Request Parameters
| Key | Datatype | Parameter Type | Required | Description | Default |
|---|---|---|---|---|---|
| access_token | string | URL | Yes | access token which archived from OAuth authentication step | |
| opt | int | Body | Optional | 0 – Only uninstall client agent from device but keep the data in Cloud database 1 – Remove Cloud database entry for the device as well as uninstall the client agent from device 2 – Archive Cloud database entry for the device as well as uninstall the client agent from device | 1 |
| MAC_list | array<string> | Body | Optional | MAC addresses of devices you want to delete. Don't use this parameter if you already use HWID_list in the body | |
| HWID_list | array<string> | Body | Optional | HWIDs of devices you want to delete. Don't use this parameter if you already use MAC_list in the body |
Response HTTP Code
| HTTP Code | Description |
|---|---|
| 200 | Success |
| 400 | Bad request |
| 401 | Unauthorized. Your access_token is invalid or expired |
Response Parameters
| Key | DataType | Description |
|---|---|---|
| result | array<int> | The result of batch delete operation. Result[i] value means that
|
Note: reasons cause failure in deleting a device
the cloud couldn't find any devices which reports the given MAC address or HWID
the given MAC address is invalid
Example
Example Request
Example Response
Was this page helpful?