Tenable One icon

Tenable One

Interact with Tenable One Exposure Management API

Actions18

Inventory → Search Findings

AI-generated

Summary

Search inventory findings via query string with optional filters and pagination controls.

Inputs

  • returnAll — Whether to return all results across all pages (auto-paginates) or stop at the specified limit. Default: false.
  • queryMode — Search mode to use. 'simple' uses asset name or ID; 'advanced' uses a query string (e.g., 'Assets HAS sources = CLOUD'). Default: 'simple'.
  • queryText — The search query text. In simple mode: asset name or ID. In advanced mode: query string.
  • filters — JSON array of filter objects, each containing 'property', 'operator', and 'value' fields.
  • searchOptions — Pagination and sorting configuration. Contains optional 'extra_properties' (comma-separated list), 'limit' (1-1000, default 100), 'offset' (default 0), and 'sort' (property:direction, e.g., 'aes:desc').

Output shape

Array of finding objects from the Tenable One API. When 'Return All' is enabled, all available results are auto-paginated and returned as a single array. Otherwise, a single page of results is returned, capped by the optional Limit parameter.

The operation sends a POST request to '/api/v1/t1/inventory/findings/search'. The query mode and text are sent as a 'query' object in the request body. Filters (if provided) are also included in the body. Pagination parameters (limit, offset, sort, extra_properties) are sent as query string parameters.

Links

Discussion