{
  "opencollection": "1.0.0",
  "info": {
    "name": "Downloads About Filters API",
    "version": "1.0.0"
  },
  "request": {
    "auth": {
      "type": "apikey",
      "key": "Authorization",
      "value": "{{Authorization}}",
      "placement": "header"
    }
  },
  "items": [
    {
      "info": {
        "name": "Filters",
        "type": "folder"
      },
      "items": [
        {
          "info": {
            "name": "List account filters",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://www.tenable.com/downloads/api/v2/filters/mssp/accounts"
          },
          "docs": "Lists the filtering capabilities for account endpoints that support filtering. <div class=\"perms-callout\">Requires the Basic [16] user role. See [Roles](doc:roles).</div>"
        },
        {
          "info": {
            "name": "List agent filters",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://www.tenable.com/downloads/api/v2/filters/scans/agents"
          },
          "docs": "Lists the filtering, sorting, and pagination capabilities available for agent records on endpoints that support them.<div class=\"perms-callout\">Requires the Basic [16] user role. See [Roles](doc:roles).</div>"
        },
        {
          "info": {
            "name": "List asset filters",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://www.tenable.com/downloads/api/v2/filters/workbenches/assets"
          },
          "docs": "Lists the filtering, sorting, and pagination capabilities available for assets on endpoints that support them. For more information about these filters, see [Workbench Filters](doc:workbench-filters).<div class=\"perms-callout\">Requires the Basic [16] user role. See [Roles](doc:roles).</div>"
        },
        {
          "info": {
            "name": "List asset filters v2",
            "type": "http"
          },
          "http": {
            "method": "POST",
            "url": "https://www.tenable.com/downloads/api/v2/filters/workbenches/assets",
            "body": {
              "type": "json",
              "data": "{}"
            }
          },
          "docs": "Lists the filtering, sorting, and pagination capabilities available for assets on endpoints that support them. For more information about these filters, see [Workbench Filters](doc:workbench-filters).\n\n**Caution:** This endpoint is deprecated and is tentatively scheduled for removal on November 5. Tenable recommends using the [List asset filters](ref:io-filters-assets-list) endpoint instead. Please update any existing integrations your organization may have.\n\n**Note:** This endpoint returns an a"
        },
        {
          "info": {
            "name": "List credential filters",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://www.tenable.com/downloads/api/v2/filters/credentials"
          },
          "docs": "Returns the filtering, sorting, and pagination capabilities available for scan credentials on endpoints that support them. <div class=\"perms-callout\">Requires the Basic [16] user role. See [Roles](doc:roles).</div>"
        },
        {
          "info": {
            "name": "List report filters",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://www.tenable.com/downloads/api/v2/filters/reports/export"
          },
          "docs": "Returns the filters, supported operators, data types, and allowed values for the [POST /reports/export](ref:vm-reports-create) endpoint. For more information about the supported filters, see [Report Export Filters](doc:vm-report-export-filters). <div class=\"perms-callout\">Requires the Basic [16] user role. See [Roles](doc:roles).</div>"
        },
        {
          "info": {
            "name": "List scan filters",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://www.tenable.com/downloads/api/v2/filters/scans/reports"
          },
          "docs": "Lists the filtering, sorting, and pagination capabilities available for scan records on endpoints that support them.<div class=\"perms-callout\">Requires the Basic [16] user role. See [Roles](doc:roles).</div>"
        },
        {
          "info": {
            "name": "List scan history filters",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://www.tenable.com/downloads/api/v2/filters/scans/reports/history"
          },
          "docs": "Lists the filtering, sorting, and pagination capabilities available for scan history records on endpoints that support them.<div class=\"perms-callout\">Requires the Basic [16] user role. See [Roles](doc:roles).</div>"
        },
        {
          "info": {
            "name": "List vulnerability filters",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://www.tenable.com/downloads/api/v2/filters/workbenches/vulnerabilities"
          },
          "docs": "Returns the filters available for the Vulnerabilities Workbench. For more information about these filters, see [Workbench Filters](doc:workbench-filters).<div class=\"perms-callout\">Requires the Basic [16] user role. See [Roles](doc:roles).</div>"
        },
        {
          "info": {
            "name": "List vulnerability filters v2",
            "type": "http"
          },
          "http": {
            "method": "POST",
            "url": "https://www.tenable.com/downloads/api/v2/filters/workbenches/vulnerabilities",
            "body": {
              "type": "json",
              "data": "{}"
            }
          },
          "docs": "Returns the filters available for the Vulnerabilities Workbench. For more information about these filters, see [Workbench Filters](doc:workbench-filters).\n\n**Caution:** This endpoint is deprecated and is tentatively scheduled for removal on November 5. Tenable recommends using the [List vulnerability filters](ref:io-filters-vulnerabilities-workbench-list) endpoint instead. Please update any existing integrations your organization may have.\n\n**Note:** This endpoint returns an additional filter (`"
        },
        {
          "info": {
            "name": "List scan configuration filters",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://www.tenable.com/downloads/api/v2/was/v2/configs/filters"
          },
          "docs": "Lists the filtering capabilities available for scan configurations for endpoints that support scan configuration filtering.<div class=\"perms-callout\">Requires the Basic [16] user role or the `WAS.SCAN_WAS.READ` custom role privilege. See [Roles](doc:roles) and [Permissions](doc:permissions).</div>"
        },
        {
          "info": {
            "name": "List scan filters",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://www.tenable.com/downloads/api/v2/was/v2/configs/:config_id/scans/filters",
            "params": [
              {
                "name": "config_id",
                "value": "",
                "type": "path",
                "description": "The UUID of the scan configuration that was used for the scan."
              }
            ]
          },
          "docs": "Lists the filtering capabilities available for scans for endpoints that support scan filtering. <div class=\"perms-callout\">Requires the Basic [16] user role or the `WAS.SCAN_WAS.READ` custom role privilege. See [Roles](doc:roles).</div>"
        },
        {
          "info": {
            "name": "List user-defined template filters",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://www.tenable.com/downloads/api/v2/was/v2/user-templates/filters"
          },
          "docs": "Lists the filtering capabilities available for user-defined templates for endpoints that support user-defined template filtering. <div class=\"perms-callout\">Requires either the Scan Operator [24] user role, the `WAS.SCAN_WAS.MANAGE` custom role privilege, or the `WAS.SCAN_WAS_USER_TEMPLATE.READ` custom role privilege. See [Roles](doc:roles).</div>"
        },
        {
          "info": {
            "name": "List vulnerability filters",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://www.tenable.com/downloads/api/v2/was/v2/vulnerabilities/filters"
          },
          "docs": "Lists the filtering capabilities available for vulnerability findings for endpoints that support vulnerability filtering. <div class=\"perms-callout\">Requires the Basic [16] user role or the `WAS.TOGGLE_WAS.USE` custom role privilege. See [Roles](doc:roles).</div>"
        },
        {
          "info": {
            "name": "List vulnerability filters for scan",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://www.tenable.com/downloads/api/v2/was/v2/scans/:scan_id/vulnerabilities/filters",
            "params": [
              {
                "name": "scan_id",
                "value": "",
                "type": "path",
                "description": "The UUID of the scan for which you want to list available findings filters."
              }
            ]
          },
          "docs": "Lists the filtering capabilities available for vulnerability findings on a given scan for endpoints that support vulnerability filtering. <div class=\"perms-callout\">Requires the Basic [16] user role or the `WAS.SCAN_WAS.READ` custom role privilege. See [Roles](doc:roles).</div>"
        }
      ]
    }
  ],
  "bundled": true
}