DocumentationAPI ExplorerRecipesConnectChangelogRSSSubscribe
API Explorer

Assign scanners

post
https://cloud.tenable.com/networks//scanners/

Associates a scanner or scanner group with a network object. Use this endpoint to:

  • Assign a scanner or scanner group to a custom network object.
  • Return a scanner or scanner group to the default network object.
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 assign a scanner or scanner group.

string
required

The UUID of the scanner or scanner group you want to assign to the network object. To get UUID values, use the GET /networks/{network_id}/assignable-scanners endpoint.

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.

Updated 2 months ago

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

Updated 2 months ago