TOC & Recently Viewed

Recently Viewed Topics

Delete an Asset Tag Category

User Permissions: Basic (16)

To delete an asset tag category, use the API endpoint described below.

Caution: Deleting an asset tag category automatically deletes all tag values associated with that category.

Before You Begin

Determine the category_uuid of the category 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/categories/{category_uuid}

Request Path Parameters

Attribute Type Description Required?
category_uuid string The UUID of the category you want to delete. required

Request Path Example

DELETE https://cloud.tenable.com/tags/categories/7138cd5a-76c1-433e-b62a-c60ec2d14611

Request Body Syntax

None.

HTTP Response

Response Codes

Status Description
204 Returned if Tenable.io successfully deleted the specified tag category.
404 Returned if Tenable.io could not find the specified tag category.
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-category

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.