added

Vulnerability Management: Export Assets v2

Tenable is pleased to announce the availability of the new Export assets v2 endpoint. The new v2 endpoint supersedes the Export assets v1 endpoint and adds additional functionality and improvements. The v2 endpoint supports all filters supported by the v1 endpoint in addition to new filters and parameters.

The following is a list of improvements offered by the new export assets v2 endpoint:

  • Support for Tenable Web App Scanning assets. WAS assets can be included in the asset export by specifying the value WAS with the sources parameter or the value webapp with the types parameter.
  • New filter parameters:
    • types—Returns all assets of the specified types. Supported asset types are host and webapp. If this parameter is omitted, the API uses the default value host.
    • since—Returns all assets that were updated, deleted, or terminated since the specified date. The date must be specified in the Unix timestamp format.
  • Asset chunks are returned using a new and improved data model. The new data model groups asset data more logically, thus improving readability and the ability to parse the data. The existing Download assets chunk endpoint can be used to download asset chunks generated by either the v2 or the v1 endpoint. See Download assets chunk for the assets v2 data model specification.

The new endpoint is described in the following table:

EndpointNameDescription
POST /assets/v2/exportExport assets v2Exports all assets that match the request criteria.