Create remediation goal

post

https://cloud.tenable.com/remediation/goal

Creates a remediation goal.

Note: The response does not include the new remediation goal. To retrieve it, use the search operation.

Requires the Basic [16] user role. See Roles.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

The remediation goal to create or update.

name

string

required

Specifies the name of the remediation goal.

description

string

Specifies the description of the remediation goal.

type

string

Specifies the type of the remediation goal.

status

string

Specifies the status of the remediation goal.

startdate

integer

Specifies the date and time when the remediation goal starts, as a Unix timestamp in seconds.

assetfilters

string

Specifies the asset filters to apply to the remediation goal. Use all to include every asset.

findingfilters

string

Specifies the finding filters to apply to the remediation goal, as a JSON-encoded object.

goalduedate

object

Specifies the rule that determines when the remediation goal is due.

minimumpercentage

string

Specifies the minimum percentage of findings that must be remediated for the remediation goal to be met.

conditions

string

Specifies the conditions for the remediation goal, as a JSON-encoded array.

Headers

string

enum

Defaults to application/json

Generated from available response content types

Allowed:

Responses

201

Returned if the remediation goal was created successfully.

400

Returned if the request contains invalid parameters or malformed data.

Language

Credentials

Header

Loading…

Response

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

application/json

text/html

401Returned if the request is missing valid credentials.

429Returned if you attempt to send too many requests in a specific period of time.

500Returned if Tenable encountered an internal error.