Create remediation scan

post

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

Creates a remediation scan configuration. For more information and request body examples, see Manage Remediation Scans.

Note: Tenable Vulnerability Management limits the number of scans you can create to 10,000 scans. Tenable recommends you re-use scheduled scans instead of creating new scans. An HTTP 403 error is returned if you attempt to create a scan after you have already reached the scan limit of 10,000.

Requires the Scan Operator [24] user role or the VM.VM_REMEDIATION.VM_REMEDIATION.CREATE custom role privilege. See Roles.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

uuid

string

required

The UUID for the Tenable-provided remediation scan template to use. Use the GET /editor/remediation/templates endpoint to find remediation scan template UUIDs.

settings

object

required

credentials

object

An object that specifies credential parameters that enable a scanner to authenticate a connection to a target host.

enabled_plugins

array of integers

A comma-delimited list of plugins IDs to add to a remediation scan. You can use the GET /plugins/families and GET /plugins/families/{id} endpoints to get a list of plugin families and plugins to add to the scan.

Note: This parameter is only valid for remediation scans. For more information on remediation scans and examples, see Manage Remediation Scans.

enabled_plugins

Headers

string

enum

Defaults to application/json

Generated from available response content types

Allowed:

Responses

400

Returned under the following conditions:

If your request message is missing a required parameter.
If your request was for a remediation scan and it included a user-defined template. User-defined templates are invalid for remediation scans.

403

Returned if you attempt to create a scan after you have already reached the scan limit of 10,000. Tenable recommends you re-use scheduled scans instead of creating new scans.

200Returned if Tenable Vulnerability Management successfully creates the remediation scan configuration.

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

500Returned if Tenable Vulnerability Management encounters an error while attempting to save the scan.