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, 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.

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

DELETE https://cloud.tenable.com/tags/values/{value_uuid}

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.

required

Request Path Example

DELETE https://cloud.tenable.com/tags/values/18179e00-b0e0-4fd7-be91-e9e854fe66b9

Request Body Syntax

None.

HTTP Response

Response Codes

Status Description
200 Returned if Tenable.io successfully deletes the specified tag value.
404 Returned if Tenable.io cannot find the specified tag value.
429

Returned if you attempt to send too many requests in a specific period of time. For more information, see Rate Limiting.

Response Body Syntax

None.

Reference Guide

https://cloud.tenable.com/api#/resources/tags/delete-tag-value

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