Skip to main content

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](doc:permissions).

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"
        ]
    }
}

Workflow Library Example​

List Filters for Agents with Tenable and Send Results Via Email

Workflow LibraryPreview this Workflow on desktop