Remediation Scan: Multiple Assets and Plugins

Related endpoints:

POST /scans/remediation

You can perform a remediation scan on multiple assets with multiple plugins. Add assets by specifying the target parameters, and add plugins by adding an array of plugin IDs to the enabled_plugins list. Options not passed in the request will return as null in the response.

Request Body Example:

{
  "uuid": "ad629e16-03b6-8c1d-cef6-ef8c9dd3c658d24bd260ef5f9e66",
  "settings": {
	"name": "remediationMultiple",
	"description": "string",
	"policy_id": 602,
	"enabled": false,
	"launch": "string",
	"scan_time_window": 0,
	"text_targets": "192.168.1.1/24",
	"tag_targets": [],
	"agent_group_id": [],
	"acls": "[{\"type\": \"default\", \"permissions\": 16}, {\"type\": \"user\", \"permissions\": 64, \"name\": \"admin\", \"id\": 1, \"owner\": 1}]"
  },
  "credentials": {
    "add": {
	    "Host": {
	      "Windows": [
		      {
		         "domain": "",
		         "username": "[email protected]",
		         "auth_method": "Password",
		         "password": "aJ^deq34Rc"
		      }
		    ]
	    }
    }
  },
  "enabled_plugins": [
		"11213",
		"18261"
  ]
}

Response Example:

{
  "scan": {
    "tag_type": null,
    "container_id": "7a818eb1-8351-4795-99b0-9610c8954cb4",
    "owner_uuid": "68f1b7a3-caf0-4ef6-87a5-2d31338ead34",
    "uuid": "template-54910541-1016-191c-f92d-fe58f5455d40bbac8a568ec40c26",
    "name": "remediationMultiple",
    "description": "string",
    "policy_id": 602,
    "scanner_id": null,
    "scanner_uuid": "00000000-0000-0000-0000-00000000000000000000000000001",
    "emails": null,
    "sms": "",
    "enabled": false,
    "include_aggregate": true,
    "scan_time_window": 0,
    "custom_targets": "192.168.1.1/24",
    "target_network_uuid": null,
    "auto_routed": 0,
    "remediation": 1,
    "starttime": null,
    "rrules": null,
    "timezone": null,
    "notification_filters": null,
    "shared": 0,
    "user_permissions": 128,
    "default_permissions": 0,
    "owner": "[email protected]",
    "owner_id": 28,
    "last_modification_date": 1613751173,
    "creation_date": 1613751173,
    "type": "public",
    "id": 618
  }
}

For more information on remediation scans and examples, see Manage Remediation Scans.