Developer Guidelines
10.6.2605
Search this version
Developer Guidelines
Developer Guidelines
Archived 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 v2.0
Summarize Page
Copy Markdown
Open in ChatGPT
Open in Claude
| API version | 2.0 |
|---|---|
| Last Update | 7/17/2014 |
| 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
xxxxxxxxxxhttps://gears.opswat.com/o/api/v2/devices/:value/deleteRequest Parameters
| Key | Datatype | Parameter Type | Required | Description | Default |
|---|---|---|---|---|---|
| value | string | URL | Yes | MAC Address or HWID of a device to be deleted | |
| access_token | string | URL | Yes | access token which archived from OAuth authentication step | |
| 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
| HTTP Code | Description |
|---|---|
| 200 | Success |
| 401 | Unauthorized. Your access_token is invalid or expired |
| 404 | Not found |
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** **
xxxxxxxxxx{ "result": 1, "msg": "Device has been deleted"}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 Action v2.0null
Discard 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