Tenable One icon

Tenable One

Interact with Tenable One Exposure Management API

Actions18

Inventory → Search Assets

AI-generated

Summary

Search inventory assets using simple or advanced query mode, optional filters, and pagination controls.

Inputs

  • returnAll — If true, auto-paginates to return all results across multiple requests; otherwise returns a single page respecting limit/offset.
  • queryMode — Simple mode treats queryText as an asset name or ID; Advanced mode treats it as a query string (e.g., 'Assets HAS sources = CLOUD').
  • queryText — The search query. 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 — Collection of pagination and sorting options for single-request mode.

Output shape

Array of asset/finding/software objects from the Tenable One API. When returnAll is enabled, all auto-paginated results are accumulated and returned; otherwise, a single page of results up to the specified limit is returned.

The operation POSTs to /api/v1/t1/inventory/assets/search (or /findings/search /software/search for other modes). Body includes query mode and text; filters are appended if provided. Pagination parameters (limit, offset, sort, extra_properties) are sent as query string.

Examples

Example 1: Search for a specific asset by name in simple mode, return up to 50 results.

queryMode: simple, queryText: 'MyAsset', searchOptions: { limit: 50 }

Example 2: Search assets with a CQL filter and return all matching results across pagination.

queryMode: advanced, queryText: 'Assets HAS sources = CLOUD', filters: [{property: 'sources', operator: 'contains', value: 'CLOUD'}], returnAll: true

Links

Discussion