Bulk assign scanners

Bulk assigns scanners and scanner groups to a custom network. The data in this request payload overwrites the full list of specified scanners and scanner groups previously assigned to the specified network object. If the payload excludes scanners or scanner groups previously assigned to the specified network object, Tenable Vulnerability Management returns those scanners and scanner groups to the default network. You cannot use this endpoint to bulk return scanners and scanner groups from multiple custom networks to the default network.

Requires the Administrator [64] user role or one of the following custom role privileges: VM.VM_SENSOR.VM_SCANNER.EDIT, VM.VM_SENSOR.VM_WAS_SCANNER.EDIT, or VM.VM_SENSOR.VM_NETWORK_MONITOR.EDIT. See Roles.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
string
required

The UUID of the network object where you want to bulk assign scanners and scanner groups.

Body Params
scanner_uuids
array of strings
required

A list of UUIDs for the scanners and scanner groups you want to bulk move to a network object. To get values for this list, use the GET /networks/{network_id}/assignable-scanners endpoint.

scanner_uuids*
Headers
string
enum
Defaults to application/json

Generated from available response content types

Allowed:
Responses

400

Returned if you attempt to assign an AWS scanner to the network object. For AWS assets, use network segmentation processes offered by AWS instead.

401

Returned if Tenable Vulnerability Management cannot authenticate the user account that submitted the request.

403

Returned if you do not have sufficient permissions to assign a scanner or scanner group to the specified network object.

404

Returned if Tenable Vulnerability Management could not find either the network object, the scanner object, or the scanner group object you specified.

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json
text/html