Improved
Vulnerability Management: Pagination Support for List Exclusions
1 day ago by Lance Duvall
Tenable has added new query parameters to the List exclusions endpoint to support pagination and sorting of exclusion records. These parameters enable you to control the number of results returned, paginate through large result sets, and sort exclusions by supported properties.
This enhancement enables you to:
- Limit the number of exclusions returned in a single request
- Retrieve exclusion records using offset-based pagination
- Sort exclusion results by name, type, or last modification date
The following query parameters are now supported:
| Query Parameter | Data Type | Description |
|---|---|---|
limit | Integer | Specifies the maximum number of exclusions to return in the response. If omitted, the default value is 200. The maximum allowed value is 500. |
offset | Integer | Specifies the number of records to skip for offset-based pagination. If omitted, the default value is 0. |
sort | String | Specifies the property and direction used to sort the results. The format is <property>:<direction>. Supported properties include name, type, and last_modification_date. |
This update affects the following endpoint:
| API Endpoint | Name | Update |
|---|---|---|
| GET /exclusions | List exclusions | Added support for the limit, offset, and sort query parameters. |
Example: Paginate and sort exclusions
For example, to return 100 exclusions sorted by most recently modified, you could use the following cURL request:
curl --request GET \
--url 'https://cloud.tenable.com/exclusions?limit=100&offset=0&sort=last_modification_date:desc' \
--header 'X-ApiKeys: accessKey=<YOURKEY>;secretKey=<YOURKEY>' \
--header 'accept: application/json'