TOC & Recently Viewed

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, also removes that tag from any assets where the tag was assigned.

Note: If you delete all asset tags associated with a category. retains the category. You must delete the category separately.

Before You Begin

Determine the UUID of the tag you want to delete.

HTTP Request

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

Attribute Type Description Required?
value_uuid string

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


HTTP Response

Response Codes

Status Description
200 Returned if successfully deletes the specified tag value.
404 Returned if 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


Reference Guide

Copyright © 2019 Tenable, Inc. All rights reserved. Tenable,, Tenable Network Security, Nessus, SecurityCenter, SecurityCenter Continuous View and Log Correlation Engine are registered trademarks of Tenable, Inc.., Lumin, Assure, and the Cyber Exposure Company are trademarks of Tenable, Inc. All other products or services are trademarks of their respective owners.