List asset tag filters

Returns a list of filters that you can use to create the rules for applying dynamic tags. Includes the field or tag names to match, the operators that you can use with the filter, and the rules for matching the values ('control' field), for example, a list of valid values.

For definitions of asset attribute filters you might use in tag rules, see Asset Attribute Definitions.

Caution: This endpoint does not return all filters that are available for creating dynamic tag rules. The following filters are supported by the system but are not included in this endpoint's response:

  • cloud.common.resource_tags.key — Resource Tags (By Key)
  • cloud.common.resource_tags.value — Resource Tags (By Value)

Supported operators for these filters:

  • wc — Wildcard contains
  • nwc — Wildcard does not contain
  • exists — Property exists
  • nexists — Property does not exist

You can use these filters when creating or updating tag rules via the API, even though they do not appear in the response from this endpoint. Additionally, you can use the Tenable Vulnerability Management UI to create dynamic tag rules using these filters.

Requires the Basic [16] user role. See Roles.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Headers
string
enum
Defaults to application/json

Generated from available response content types

Allowed:
Responses

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json
text/html