Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Need help?

Contact us
Kin Lane

Chat with Kin

AI assistant · trained on my blog

Tenable

Tenable Tags API

The Tenable Exposure Management tags API enables users to search for their organization's tags. Additionally, API endpoints are provided to retrieve a list of asset and tag properties that can be used as filters on endpoints that support them. For more information, see [Tagging](https://docs.tenable.com/exposure-management/Content/exposure-management/tagging/tagging.htm) in the _Tenable Exposure Management User Guide_.

Documentation Provider Profile APIs.io OpenAPI GitHub

Tenable Tags API is one of 107 APIs that Tenable publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Tags. The published artifact set on APIs.io includes an OpenAPI specification.

This API exposes 17 operations across 11 paths, and defines 25 schemas. It is described by OpenAPI 3.0.0, at version 1.0.0.

Requests are made against a single base URL, https://www.tenable.com/downloads/api/v2.

17 operations 11 paths 25 schemas 2 DELETE8 GET5 POST2 PUT

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.0.0
API Version
1.0.0
Base URL
https://cloud.tenable.com
Authentication
API Key
Resource Areas
1

Authentication & Security 1

Tenable Tags API declares 1 security scheme for authenticating requests. An API key is passed in the header as Authorization (Bearer). By default, every request must be authenticated.

  • Bearer — Example: Bearer {{token}}

Paths & Operations 17

Across 11 paths, the API surfaces 17 operations — 2 DELETE, 8 GET, 5 POST, 2 PUT. Each is listed below with its method, path, parameters, and response codes.

Tags 17

The Tenable Exposure Management tags API enables users to search for their organization's tags. Additionally, API endpoints are provided to retrieve a list of asset and tag proper…

POST
/api/v1/t1/tags/search
Search tags
inventory-tag-search 4 params body → 200400401403429500
GET
/api/v1/t1/tags/properties
List tag properties
inventory-tag-properties-list → 200400401403429500
POST
/tags/categories
Create tag category
tags-create-tag-category body → 200400401429500
GET
/tags/categories
List tag categories
tags-list-tag-categories 5 params → 200400401429500
GET
/tags/categories/{tag_category_uuid}
Get category details
tags-tag-category-details 1 param → 200401404429500
PUT
/tags/categories/{tag_category_uuid}
Update tag category
tags-edit-tag-category 1 param body → 200400401403404429500
DELETE
/tags/categories/{tag_category_uuid}
Delete tag category
tags-delete-tag-category 1 param → 200401403404429500
POST
/tags/values
Create tag value
tags-create-tag-value body → 200400401429500
GET
/tags/values
List tag values
tags-list-tag-values 7 params → 200400401429500
GET
/tags/values/{tag_value_uuid}
Get tag value details
tags-tag-value-details 1 param → 200401404429500
PUT
/tags/values/{tag_value_uuid}
Update tag value
tags-update-tag-value 1 param body → 200400401403404429500
DELETE
/tags/values/{tag_value_uuid}
Delete tag value
tags-delete-tag-value 1 param → 200401403404429500
POST
/tags/values/delete-requests
Bulk delete tag values
tags-delete-tag-values-bulk body → 200400401403429500
POST
/tags/assets/assignments
Add or remove asset tags
tags-assign-asset-tags body → 202400401403429500
GET
/tags/assets/{asset_uuid}/assignments
List tags for an asset
tags-list-asset-tags 1 param → 200401429500
GET
/tags/values/{tag_value_uuid}/exclusions
List tag exclusions
tags-list-exclusions 4 params → 200401429500
GET
/tags/assets/filters
List asset tag filters
tags-list-asset-filters → 200401429500

Schemas 25

The contract defines 25 schemas that model the data the API accepts and returns. The most detailed are tags_ValueDetails (13 properties), tags_ListValueDetails (12 properties), tags_Response-List-Tags-for-Asset (10 properties), Inventory_Response-Search-Tags-Object (8 properties). Each schema is shown below with its type and property counts.

tags_rule
object
A rule for applying the tag to assets by matching asset properties or other tags. Includes a field or tag name, an operator, and a value.
3 properties
tags_Response-List-Tag-Exclusions
object
5 properties
Inventory_Request-Search-Tags
object
An object containing a query and/or filters to search for tags.
2 properties
tags_filter
object
A filter definition. Includes the field to be matched, the operators that you can use with the filter, and the rules for matching the values (control field), f…
4 properties
Inventory_Control
object
4 properties
tags_PaginationResponseShort
object
An object containing pagination information for the current result set.
3 properties
tags_Category
object
8 properties
Inventory_Properties-Object
object
7 properties
tags_ValueDetails
object
13 properties
tags_orConditions
array
To apply the tag to assets that match any of the rules, specify the rules inside the or object. Note: The value you specify for the rule attribute is not case…
tags_filters
array
A list of available filters that you can use to define the rules for applying tags to assets.
tags_Response-List-Tags-for-Asset
object
10 properties
tags_ErrorResponse
object
3 properties
tags_PaginationResponse
object
An object containing pagination information for the current result set.
4 properties
tags_ListValueDetails
object
12 properties
tags_DomainPermission
object
4 properties
Inventory_Response-Search-Tags
object
The tag search results.
2 properties
tags_andConditions
array
To apply the tag to assets that match all of the rules, specify the rules inside the and object. Note: The value you specify for the rule attribute is not case…
tags_CategoryListResponse
object
2 properties
tags_PaginationResponseSortObject
object
An object specifying how the current result set is sorted, including the property by which the results were sorted and the sort direction.
2 properties
tags_ValueListResponse
object
2 properties
tags_AccessControl
object
Determines what the user can do with the tag value. Caution: Most customers have been migrated to role-based access control and should use the [POST /api/v3/ac…
5 properties
Inventory_ErrorResponse
object
3 properties
Inventory_Public-Sort-Object
object
An object specifying how the current result set is sorted, including the property by which the results were sorted and the sort direction.
2 properties
Inventory_Response-Search-Tags-Object
object
8 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

tenable-tags-api-openapi.yml Raw ↑

Other APIs Tenable publishes across the network.

Tenable About API
AE Profile APIs.io
Tenable Access Control (API) API
AE Profile APIs.io
Tenable Access Control (Groups) API
AE Profile APIs.io
Tenable Access Control (Permissions) API
AE Profile APIs.io
Tenable Access Control (Roles) API
AE Profile APIs.io
Tenable Access Control (Users) API
AE Profile APIs.io
Tenable Access Groups v1 API
AE Profile APIs.io
Tenable Access Groups v2 API
AE Profile APIs.io
Tenable Account Groups API
AE Profile APIs.io
Tenable Accounts API
AE Profile APIs.io
Tenable Activity Log API
AE Profile APIs.io
Tenable AD object API
AE Profile APIs.io
#Tags
← Back to T APIs
API Details
ID
tenable:tenable-tags-api
Base URL
https://cloud.tenable.com
Docs
https://developer.tenable.com/reference/navigate
Provider
Tenable
APIs.io →  GitHub →
Explore more
All APIs Providers APIs.io Network