Tenable.io Asset Age Out
Tenable.io now offers the option to automatically delete assets in a network after a specified number of days. The assets_ttl_days body parameter can be specified when creating or updating a network. Additionally, a new endpoint has been added that allows you to return the total number of assets in a network along with the number of assets that have not been seen for a specified number of days.
The new parameter:
| Parameter | Type | Description |
|---|---|---|
assets_ttl_days | Integer | The number of days to wait before assets age out. Assets will be permanently deleted if they are not seen on a scan within the specified number of days. The minimum value is 14 and the maximum value is 365. |
⚠️Warning
If you enable this option, Tenable.io immediately deletes assets in the specified network that have not been seen for the specified number of days. All asset records and associated vulnerabilities are deleted and cannot be recovered. The deleted assets no longer count towards your license.
The changes affect the following endpoints:
| API Endpoint | Description | Change |
|---|---|---|
| POST /networks | Create network | Added the assets_ttl_days body parameter. |
| PUT /networks/{network_id} | Update network | Added the assets_ttl_days body parameter. |
| GET /networks/{network_id}/assets-not-seen-in{num_days} | Get network asset count | New endpoint that returns the total number of assets in a network along with the number of assets that have not been seen for a specified number of days. |