Developer Guidelines
10.4.2602
Search this version
Developer Guidelines
Developer Guidelines
oAuth APIs
Title
Message
Create new category
What is the title of your new category?
Edit page index title
What is the title of the page index?
Edit category
What is the new title of your category?
Edit link
What is the new title and URL of your link?
Delete Device
Summarize Page
Copy Markdown
Open in ChatGPT
Open in Claude
| 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/deleteRequest 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 HTTP Code
See details in the Response HTTP Code section in this page
Response Parameters
| Key | Datatype | Description |
|---|---|---|
| result | int | 0 - failure 1 - success |
| msg | string | Result details |
Example
*_Request *_Example
https://gears.opswat.com/o/api/v2.2/devices/0CQN6GRVGU2F1/delete?opt=0&access_token=TEST7P9ZMJ2LBF8AMOMJLFNPMMLO953AVQ4C9YFF52R61234Response Example** **
{ "result": 1, "msg": "Device has been deleted"}History
| Version | Link |
|---|---|
| 2.0 | auto$ |
Type to search, ESC to discard
Type to search, ESC to discard
Type to search, ESC to discard
Last updated on
Was this page helpful?
Next to read:
Device StatisticsDiscard Changes
Do you want to discard your current changes and overwrite with the template?
Archive Synced Block
Message
Create new Template
What is this template's title?
Delete Template
Message
