Actions52
- Asset Actions
- Data Import Job Actions
- Job Config Actions
- Notification Actions
- Parser Actions
- Vulnerability Actions
- Vulnerability Audit Log Actions
- Vulnerability Detection Actions
- Vulnerability Detection Rule Actions
- Zone Actions
Asset → Search
AI-generatedSummary
Search assets with optional pagination and sorting parameters to retrieve matching asset records from the Dragos platform.
Inputs
- Return All — Boolean indicating whether to return all matching assets (up to 1000) or only up to the specified limit.
- Limit — Maximum number of asset results to return if 'Return All' is false (minimum 1, maximum 1000). Defaults to 50.
- Options — Collection of optional parameters to control sorting behavior: 'Sort Field' (field name to sort by) and 'Sort Descending' (boolean for descending order).
Output shape
a list of asset records matching the search criteria
If 'Return All' is true, up to 1000 assets are returned; otherwise, the number of results is limited by 'Limit'. The results are returned as an array in the response's 'content' property.
Examples
Example 1: Search assets with a limit
Set 'Return All' to false and specify a 'Limit' to retrieve up to that number of assets.
Example 2: Search all assets with sorting
Set 'Return All' to true and specify 'Sort Field' and optionally 'Sort Descending' to retrieve up to 1000 assets sorted accordingly.