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
optintBodyOptional

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_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
VariableType to search · ESC to discard
GlossaryType to search · ESC to discard
InsertType to search · ESC to discard
No matches
Next to read:
Delete Device v2.0
null
On This Page
Delete Devices v2.0API URLRequest ParametersResponse HTTP CodeResponse ParametersExample