DocumentationAPI ExplorerRecipesConnectChangelogRSSSubscribe
API Explorer

Bulk delete tag values

post
https://cloud.tenable.com/tags/values/delete-requests

Deletes tag values in bulk. If you delete an asset tag, Tenable Vulnerability Management also removes that tag from any assets where the tag was assigned. If you delete all asset tags associated with a category, Tenable Vulnerability Management retains the category. You must delete the category separately.

Requires the Scan Operator [24] user role. See Roles.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params
values
array of uuids

A list of the unique identifiers (UUIDs) of the tag values 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. For more information on determining this value, see Determine Tag Identifiers.

values
Headers
string
enum
Defaults to application/json

Generated from available response content types

Allowed:
Responses

400

Returned if your request specified invalid parameters, invalid tag value UUIDs, or if your request was improperly formatted.

403

Returned if you do not have permissions to delete tag values.

Updated about 2 months ago

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json
text/html

Updated about 2 months ago