Recently Viewed Topics
Delete a Single Asset Tag
User Permissions: Basic (16)
To delete a single asset tag, use the API endpoint described below.
If you delete an asset tag, Tenable.io also removes that tag from any assets where the tag was assigned.
Note: If you delete all asset tags associated with a category. Tenable.io retains the category. You must delete the category separately.
Before You Begin
Determine the UUID of the tag you want to delete.
Note: To authenticate your request, be sure to include API keys in the HTTP header of the request. For more information, see Authorization.
Request Path Syntax
Request Path Parameters
The UUID of the tag you want to delete.
Note: A tag UUID is technically assigned to the tag value only (the second half of the category:value pair), but the API commands use this value to represent the whole category:value pair.
Request Path Example
Request Body Syntax
|200||Returned if Tenable.io successfully deletes the specified tag value.|
|404||Returned if Tenable.io cannot find the specified tag value.|
Returned if you attempt to send too many requests in a specific period of time. For more information, see Rate Limiting.
Response Body Syntax