Tenable One: Inventory Export and Asset Search
Tenable is pleased to announce the release of the Inventory Export API for Tenable One. This API enables users to asynchronously export asset and findings data in either JSON or CSV format. The workflow includes endpoints to initiate an export, check export status, and download export chunks.
For detailed information about assets and findings, refer to the following pages in the Tenable Exposure Management User Guide:
Caution
These endpoints are currently in beta and may change as we refine and enhance the data models. Use with caution in production environments.
The new Inventory Export endpoints are described in the following table:
| Endpoint | Name | Description |
|---|---|---|
| POST /api/v1/t1/inventory/export/assets | Export assets | Initiates an export of assets that match the specified search criteria. |
| GET /api/v1/t1/inventory/export/findings | Export findings | Initiates an export of findings that match the specified search criteria. |
| GET /api/v1/t1/inventory/export/{export_id}/status | Get export status | Returns the current status of an export request. |
| GET /api/v1/t1/inventory/export/{export_id}/download/{chunk_id} | Download export | Downloads a specific export chunk in JSON or CSV format. |
Tenable has also released new Tenable One Inventory endpoints for asset search and asset property discovery. These endpoints enable users to search for assets and retrieve available filterable properties.
In support of the new findings export, Tenable has also added an endpoint to retrieve available findings properties.
| Endpoint | Name | Description |
|---|---|---|
| POST /api/v1/t1/inventory/assets/search | Search assets | Returns a list of assets in your organization that match the specified search criteria. |
| GET /api/v1/t1/inventory/assets/properties | List asset properties | Returns a list of asset properties that can be used as filters on endpoints that support them. For example, the properties that are returned by this endpoint can be used as filters for the Search assets or Export assets endpoints. |
| GET /api/v1/t1/inventory/findings/properties | List finding properties | Returns a list of finding properties that can be used for filters on endpoints that support them. For example, the properties that are returned by this endpoint can be used as filters for the Export findings endpoint. |
Tip
pyTenable has been updated to support the new Inventory Export APIs, enabling programmatic access to export workflows in Python.