Delete Devices v2.0

API version2.0
Last Update08/19/2014
AuthenticationYES
Response FormatJSON
HTTP MethodPOST
Rate limitedYES
Requests per rate limit10/min

Use to delete devices on an account

API URL

Copy

Request Parameters

KeyDatatypeParameter TypeRequiredDescriptionDefault
access_tokenstringURLYesaccess token which archived from OAuth authentication step
optintBodyOptional0 – 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_listarray<string>BodyOptionalMAC addresses of devices you want to delete. Don't use this parameter if you already use HWID_list in the body
HWID_listarray<string>BodyOptionalHWIDs of devices you want to delete. Don't use this parameter if you already use MAC_list in the body

Response HTTP Code

HTTP CodeDescription
200Success
400Bad request
401Unauthorized. Your access_token is invalid or expired

Response Parameters

KeyDataTypeDescription
resultarray<int>

The result of batch delete operation. Result[i] value means that

  • 0: couldn't delete devices[i] in the list

  • 1: delete devices[i] in the list successfully

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

Copy

Example Response

Copy
Type to search, ESC to discard
Type to search, ESC to discard
Type to search, ESC to discard
Next to read:
Delete Device v2.0
On This Page
Delete Devices v2.0API URLRequest ParametersResponse HTTP CodeResponse ParametersExample