DocumentationAPI ExplorerRecipesConnectChangelogRSSSubscribe
API Explorer
Start typing to search…

Create recast rule

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

Creates a new recast or accept rule.

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

Body Params
string
length ≤ 1024

A name for the rule.

If not provided, a default is generated using the following format: rule type (Recast or Accept), the plugin ID (for Vulnerabilities and Web Applications) or the audit file name (for Host Audits), and the rule creation date. For example, Recast - Plugin ID: 123642 - Created: 2023-03-14.

string
length ≤ 1024

A description of the rule.

string
enum
required

Specifies the type of findings that the rule will target.

Allowed:
rule_value
object
required

Defines the configuration of the rule based on the selected action.

filter
required

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.

date-time

The date and time when the rule expires, in ISO 8601 format. If omitted, the rule does not expire.

disabled_details
object

Specifies details for disabling the rule.

Headers
string
enum
Defaults to application/json

Generated from available response content types

Allowed:
Responses

400

Returned if your request specified invalid parameters, if your request was improperly formatted, or if you attempted to create a duplicate rule.

403

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

Updated 29 days ago

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
Updated 29 days ago