Export assets v2

post

https://cloud.tenable.com/assets/v2/export

Exports all assets that match the request criteria.

This endpoint supersedes the Export assets v1 endpoint. Export assets v2 adds support for Tenable Web App Scanning assets. WAS assets can be included in the export by specifying WAS with the sources parameter or webapp with the types parameter. The Export assets v2 endpoint supports most filters supported by Export assets v1 in addition to the new types and since parameters. The tag filter (tag.<category>) available in Export assets v1 is not supported in this endpoint. Additionally, the asset chunks are returned using an improved data model. See Download assets chunk for the assets v2 data model specification.

Users need at least the Basic [16] user permission or the VM.VM_EXPLORE.VM_EXPLORE.EXPORT custom role privilege. Additionally, requires the Can View access control permission for the asset objects to be exported. The Can View access control permission can be set for all assets with the All Assets object. Administrator [64] users can export without the explicit Can View access control permission. FedRAMP customers who use the GovCloud region must have the Administrator [64] user permission.

For more information about this endpoint, see guidelines and limitations described in Retrieve Asset Data from Vulnerability Management.

Note: There are limits for concurrent export requests. For more information, see Concurrency Limiting and Rate Limiting.

Requires the Basic [16] user role or the VM.VM_EXPLORE.VM_EXPLORE.EXPORT custom role privilege. Additionally, requires the Can View access control permission for the asset objects to be exported. Administrator [64] users can export without the explicit Can View access control permission. FedRAMP customers who use the GovCloud region must have the Administrator [64] user permission. See Roles and Permissions.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

chunk_size

int32

required

100 to 10000

Specifies the number of assets per exported chunk. The range is 100-10000. If you specify a value outside of that range, Tenable Vulnerability Management returns a 400 error.

Using smaller chunks size can improve performance. Tenable does not recommend using a chunk size larger than 5000 as the potential for an error increases above this size.

Caution: if using the include_resource_tags parameter, the chunk size is limited to 1000 for best performance, and Tenable Vulnerability Management returns a 400 error if you attempt to use a larger chunk size.

include_open_ports

boolean

Specifies whether or not to include open port findings from info-level plugins. If this parameter is omitted, Tenable Vulnerability Management uses a default value of false.

Caution: Including open port findings can significantly increase the size of the API response and exports take longer to complete. Additionally, Tenable does not recommend including both open port findings and resource tags in the same export.

include_resource_tags

boolean

Specifies whether or not to include resource tags. Resource tags are imported from a cloud provider like AWS, Azure, or GCP by a Cloud Discovery Connector and are used to identify cloud assets. If this parameter is omitted, Tenable Vulnerability Management uses a default value of false.

Note: Tenable is enabling this update for customers in a rolling fashion and availability is limited. For more information, contact your Tenable representative.

Caution: Including resource tags can significantly increase the size of the API response and exports take longer to complete. Tenable does not recommend including both resource tags and open port findings in the same export. Additionally, when including resource tags, the chunk size is limited to 1000 for best performance and Tenable Vulnerability Management returns a 400 error if you attempt to use a larger chunk size.

filters

object

Specifies filters for exported assets. To return all assets, omit the filters object. If your request specifies multiple filters, the system combines the filters using the AND search operator.

Note: If you submit an asset export request with filters that are identical to a previously submitted asset export request then the old export is canceled and a new export is submitted.

Headers

string

enum

Defaults to application/json

Generated from available response content types

Allowed:

Responses

400

Returned if your request specified invalid parameters or if your request was improperly formatted.

403

Returned if you do not have permission to export assets.

409

Returned if your export request is identical to a request already in progress. For more information, see Concurrency Limiting.

200Returned if Tenable Vulnerability Management successfully queued an assets export request.

401Returned if the API keys specified in your request are invalid.

429Returned if you attempt to send too many requests in a specific period of time. For more information, see Rate Limiting.

500Returned if an internal error occurred in Tenable Vulnerability Management.