Refine Asset Export Requests

Refine the assets you export from Tenable Vulnerability Management using parameters in the request body of the Export assets v1 or Export assets v2 endpoint.

📘

Note

The following examples only apply to the Export assets v1 endpoint.

Request Body Example 1: ServiceNow, Created_at, and Sources

{
  "chunk_size": 100,
  "filters": {
    "servicenow_sysid": false,
    "created_at": 1739944847,
    "sources": [
      "NESSUS_SCAN"
    ]
  }
}

In this example, the request message contains the servicenow_sysid filter specifying false, a created_at filter specifying February 19, 2025, and a source filter specifying Nessus scans. The export includes all assets created later than February 19, 2025 that were discovered via a Nessus scan and that do not have a ServiceNow ID.

Request Body Example 2: Single Tag with Multiple Values

{
  "chunk_size": 100,
  "filters": {
    "tag.Location": [
      "Austin",
      "Dallas",
      "Fort Worth"
    ]
  }
}

In this example, the request message contains a tag. The tag category is Location and the tag values are Austin, Dallas, and Fort Worth. When multiple tag values are provided, the logical operation applied to the values is an OR operation.

The resulting export includes only assets that are assigned any of the following tags:

• Location:Austin
• Location:Dallas
• Location:Fort Worth

Request Body Example 3: Multiple Tags with Multiple Values

{
  "chunk_size": 100,
  "filters": {
    "tag.Location": [
      "Austin",
      "Dallas",
      "Fort Worth"
    ],
    "tag.OperatingSystem": [
      "Windows",
      "Linux"
    ]
  }
}

In this example, the request message contains multiple tags. The first tag category is Location and the tag values are Austin, Dallas, and Fort Worth. The second tag category is OperatingSystem and the tag values are Windows and Linux. When multiple tag categories are provided, the logical operation applied to the tag categories is an AND operation.

The resulting export includes only assets that are assigned any of the following tags:

• [Location.Austin OR Location.Dallas OR Location.Fort Worth] AND [OperatingSystem:Windows OR OperatingSystem:Linux]