added
New POST Method Available for Filters Endpoints
almost 4 years ago by Lance Duvall
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. |