Skip to content

Feature Request: Filter Vulnerability Export by Asset UUID #984

@Smogin

Description

@Smogin

Feature Request: Filter Vulnerability Export by Asset UUID

Endpoint: POST /vulns/export

Problem

Currently, the Vulnerability Management export API does not support filtering vulnerabilities by asset_uuid. This makes it difficult to retrieve a consolidated view of all vulnerabilities associated with a specific asset.

The available workarounds have significant limitations:

  • Filtering by cidr_range may return vulnerabilities from multiple assets sharing the same IP, or miss assets with dynamic/multiple IPs.
  • Filtering by scan_uuid only returns vulnerabilities detected in a single scan execution, not the full consolidated history of the asset.

In contrast, the WAS export API (POST /was/v1/export/vulns) already supports asset_uuid as a filter. Having the same capability in the VM export API would provide consistency across both products.

Proposed Solution

Add asset_uuid as a supported filter parameter in the POST /vulns/export endpoint, accepting one or more UUIDs:

{
  "filters": {
    "asset_uuid": [
      "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
    ],
    "state": ["OPEN", "REOPENED"]
  }
}

Use Case

When building integrations or dashboards that aggregate vulnerability data per asset — across both VM and WAS sources — it is essential to query vulnerabilities using a stable, unique identifier. The asset_uuid is already shared across both products and is the natural key for this kind of cross-source correlation.

Expected Behavior

The export should return all open/reopened/fixed vulnerabilities associated with the specified asset UUID(s), reflecting the consolidated state as shown in the Tenable Vulnerability Management UI.

Current Behavior

The asset_uuid filter is not available in POST /vulns/export. The closest alternative (cidr_range) is unreliable for assets with dynamic or multiple IP addresses.

Additional Context

  • The WAS export API already supports this filter: POST /was/v1/export/vulnsfilters.asset_uuid
  • This feature would significantly simplify integrations that need a unified vulnerability view per asset across VM and WAS sources.

Metadata

Metadata

Assignees

No one assigned

    Labels

    Tenable VMTenable.io Packageupstream-apiThe issue is related to the calling API or API Docs

    Type

    No type
    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions