Test scan routes

post

https://cloud.tenable.com/scans/check-auto-targets

Evaluates a list of targets and/or tags against the scan route configuration of scanner groups. Returns the list of missed targets (if any) and the list of matched scanner groups (if any).

Requires the Scan Operator [24] user role. See Roles.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Query Params

limit

int32

Defaults to null

Limit the number of missed targets returned in the response.

matched_resource_limit

int32

Defaults to null

Limit the number of matched resource UUIDs returned in the response.

Body Params

network_uuid

string

required

Specify a value as follows:

If your scans involve separate environments with overlapping IP ranges, specify the UUID of the network you want to associate with the results of the auto-routed scan. This value must match the network where you have assigned the scanner groups that you configured for scan routing.
Otherwise, specify the default network (00000000-0000-0000-0000-000000000000).

tags

target_list

string

A comma-delimited list of targets to scan. For a full list of supported target formats, see the Tenable Vulnerability Management User Guide.

Headers

string

enum

Defaults to application/json

Generated from available response content types

Allowed:

Responses

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

200Returned if Tenable Vulnerability Management successfully evaluated the list of targets or tags against the scan route configuration.

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