Fleet Intelligence — ReferenceAPI Exploreralerts

List impacted machines with alert summary (level 1)

View as Markdown
Returns a paginated list of nodes with per-node alert counts and inventory metadata for the Alerts panel. Use active=true for the Active Alerts view (only nodes with currently active alerts) or active=false for Historical Alerts. Cross-page aggregates (totalCritical, totalWarning, distinctGpuTypeCount, etc.) reflect the full filtered result set and drive table header counts. componentVisibility is resolved server-side from the user's auth persona and is not an HTTP parameter.

Query parameters

activebooleanOptionalDefaults to false

Active Alerts view when true; Historical Alerts when false (default: false)

pageintegerOptionalDefaults to 0

Page number (0-indexed, default: 0)

pageSizeintegerOptionalDefaults to 50

Number of nodes per page (default: 50, max: 100)

hostnamestringOptional

Case-insensitive partial match on hostname

sortByenumOptionalDefaults to alert

Sortable table-header column. alert ranks by critical then warning count.

orderenumOptionalDefaults to desc
Sort direction for sortBy
Allowed values:
gpuTypeslist of stringsOptional

Filter to nodes with matching GPU types (OR within dimension)

nodeGroupIdslist of stringsOptional

Filter to nodes in matching node groups by node group ID (OR within dimension)

computeZoneIdslist of stringsOptional

Filter to nodes in matching compute zones by compute zone ID (OR within dimension)

alertStateslist of enumsOptional

Filter to nodes with at least one alert whose state matches (OR within dimension). Resolved applies to the Historical view only (active=false).

Allowed values:
componentTypeslist of stringsOptional

Filter to nodes with alerts on matching component types. Use the value ‘psirt’ to match all security-vulnerability CVEs (the collapsed ‘Security Vulnerability’ option).

Response

List of nodes with alert summary
distinctComputeZoneCountintegerOptional
Distinct compute zones among matching nodes
distinctGpuTypeCountintegerOptional
Distinct GPU types among matching nodes
distinctNodeGroupCountintegerOptional
Distinct node groups among matching nodes
hasMorebooleanOptional
nodeslist of objectsOptional
pageintegerOptional
pageSizeintegerOptional
totalintegerOptional
Total number of nodes matching filters across all pages
totalCriticalintegerOptional

Cross-page critical alert total; drives ALERT header

totalResolvedintegerOptional

Cross-page resolved alert total; historical view only

totalWarningintegerOptional

Cross-page warning alert total

Errors

400
Bad Request Error
401
Unauthorized Error
499
Client Closed Request Error
500
Internal Server Error