For AI agents: a documentation index is available at the root level at /llms.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
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)
pageSizeintegerOptionalDefaults to 50
Number of nodes per page
hostnamestringOptional
Case-insensitive partial match on hostname
onlineOnlybooleanOptionalDefaults to false
When true, return only nodes whose liveness state is Healthy/Degraded and has no unhealthy in-band or OOB liveness state. Omit or use false to return all nodes.
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
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
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.
