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

Parameter	Type	Description	Required?
filter.0.filter	string	Identifier. 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.quality	string	Operator. For asset tags, eq is the only supported operator.	required to filter on tag
filter.0.value	string	The 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'