List agents

Returns a list of agents for the specified scanner.

Requires the Scan Manager [40] user role. See Roles.

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

Apply a filter in the format ::. For example, field1:match:sometext would match any records where the value of field1 contains sometext. You can use multiple query filters.

Use the List agent filters endpoint to retrieve the list of supported filters, including their valid operators and value types.

string

Filter type. If the filter type is and, the record is only returned if all filters match. If the filter type is or, the record is returned if any of the filters match.

string

Wildcard filter text. Wildcard search is a mechanism where multiple fields of a record are filtered against one specific filter string. If any one of the wildcard_fields' values matches against the filter string, then the record matches the wildcard filter. For a record to be returned, it must pass the wildcard filter (if there is one) AND the set of standard filters. For example, if w=wild&f=field1:match:one&f=field2:match:two&ft=or, the record would match if the value of any supported wildcard_fields contained wild, AND either field1's value contained one or field2's value contained two.

string

A comma-delimited subset of wildcard_fields to search when applying the wildcard filter. For example, field1,field2. If w is provided, but wf is not, then all wildcard_fields' values are searched against the wildcard filter text.

int32

The number of records to retrieve. If this parameter is omitted, Tenable Vulnerability Management uses the default value of 50. The minimum supported limit is 1, and the maximum supported limit is 5000.

int32

The starting record to retrieve. If this parameter is omitted, Tenable Vulnerability Management uses the default value of 0.

string

The field you want to use to sort the results by along with the sort order. The field is specified first, followed by a colon, and the order is specified second (asc or desc). For example, name:desc would sort results by the name field in descending order.

If you specify multiple fields, the fields must be separated by commas. For example, name:desc,platform:asc would first sort results by the name field in descending order and then by the platform field in ascending order.

Sort can only be applied to the sortable_fields specified by the filter capabilities. There may be no more than max_sort_fields number of columns used in the sort, as specified by the filter capabilities.

Headers
string
enum
Defaults to application/json

Generated from available response content types

Allowed:
Responses

403

Returned if you do not have permission to view the list of agents.

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