List Filters For Agents

Lists the filtering, sorting, and pagination capabilities available for agent records on endpoints that support them. Requires BASIC [16] user permissions. See Permissions.

External Documentation

To learn more, visit the Tenable documentation.

​

Example Output

{
	"value": {
		"filters": [
			{
				"control": {
					"readable_regex": "X.Y.Z",
					"regex": ".*",
					"type": "entry"
				},
				"name": "core_version",
				"operators": [
					"eq",
					"neq",
					"match",
					"nmatch"
				],
				"readable_name": "Version"
			},
			{
				"control": {
					"readable_regex": "Distro Name (e.g. es7-x86-64)",
					"regex": ".*",
					"type": "entry"
				},
				"name": "distro",
				"operators": [
					"match",
					"nmatch"
				],
				"readable_name": "Distro"
			},
			{
				"control": {
					"list": [
						{
							"id": -1,
							"name": "None"
						},
						{
							"id": 106592,
							"name": "slibs"
						}
					],
					"type": "dropdown"
				},
				"name": "groups",
				"operators": [
					"eq",
					"neq"
				],
				"readable_name": "Member of Group"
			}
		],
		"sort": {
			"sortable_fields": [
				"core_version",
				"distro",
				"ip",
				"last_connect",
				"last_scanned",
				"name",
				"platform",
				"plugin_feed_id"
			]
		},
		"wildcard_fields": [
			"core_version",
			"distro",
			"groups"
		]
	}
}