Search recast rules

post

https://cloud.tenable.com/v1/recast/rules/search

Searches for rules that match the requested criteria.

Requires the Administrator [64] user role or one of the following custom role privileges: TIO_BACKEND.RECAST_RULE.READ for Vulnerability Management or WAS.RECAST_RULE.READ for Web App Scanning. See Roles.

Body Params

resource_type

array of strings

The type of findings targeted by the recast rules to search for. Supported values are HOST, HOST_AUDIT, and WEBAPP.

resource_type

filter

Filter rules based on the targeted vulnerabilities. Use the and array to combine multiple conditions that all must be true. Use the or array to combine multiple conditions where at least one must be true.

limit

integer

1 to 500

Defaults to 100

The number of records to retrieve. If this parameter is omitted, Tenable uses the default value of 100. The minimum value is 1, and the maximum value is 500.

sort

array of objects

The property you want to use to sort the results by along with the sort order.

sort

Headers

string

enum

Defaults to application/json

Generated from available response content types

Allowed:

Responses

400

Returned if your request specified invalid parameters or if your request was improperly formatted.

403

Returned if you do not have permission to search recast rules.

Language

Credentials

Header

Request

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

text/html

200Returned if the search results were retrieved successfully.

401Returned if the API keys specified in your request are invalid.

429Returned if you attempt to send too many requests in a specific period of time. For more information, see Rate Limiting.

500Returned if an internal error occurred.