List Assets for a Specific Tag

Before you begin

  • Determine the category name and tag value for the tag you want to use to filter assets.

To list assets for a specific tag, use the GET /workbenches/assets endpoint with the query parameters listed below.

Request Query Parameters

ParameterTypeDescriptionRequired?
filter.0.filterstringIdentifier. The asset attribute on which you want to filter. For asset tags, this attribute must be in the following format:
tag.category_name
required to filter on tag
filter.0.qualitystringOperator. For asset tags, eq is the only supported operator. required to filter on tag
filter.0.valuestringThe value you want to filter on. For asset tags, this is the tag value.required to filter on tag

Request Body Example

curl --request GET \
  --url 'https://cloud.tenable.com/workbenches/assets?filter.0.filter=tag.Location&filter.0.quality=eq&filter.0.value=Chicago' \
  --header 'accept: application/json'

Did this page help you?