New POST Method Available for Filters Endpoints
Caution
The information in this changelog is outdated. The referenced endpoints have been deprecated. This changelog remains publicly available for historical reference only. For the official deprecation announcement, see Vulnerability Management: Deprecated Filter Endpoints.
There are two existing endpoints available for retrieving the filtering, sorting, and pagination capabilities available for assets and vulnerabilities. These two endpoints are GET /filters/workbenches/assets and GET /filters/workbenches/vulnerabilities.
Tenable.io now supports a POST method for these two endpoints that return an additional filter (tag_uuid), displayed as Tag (Category: Value), that is not returned when using the GET version of these endpoints.
New POST method version of these endpoints:
| API Endpoint | Name |
|---|---|
| POST /filters/workbenches/assets | List asset filters v2 |
| POST /filters/workbenches/vulnerabilities | List vulnerability filters v2 |
Additionally, with the POST method version of the two endpoints, you can pass a a list of tag UUIDs in the tag_uuids body parameter that are guaranteed to be returned in the initial data set of the tag-uuid filter, if the tags exist.
| Parameter | Type | Description |
|---|---|---|
| tag_uuids | array of strings | A list of tag UUIDs that are guaranteed to be returned in the initial data set of the tag_uuid filter, if the tags exist. |