List discovered AI agents.

Returns one page of the tenant's agents — one row per (agent, device) pair — filtered, sorted and
paged entirely in SQL. Supports free-text search, combined-risk-band filtering and sorting.


An empty result is { "total": 0, "items": [] } and never a 404: an empty fleet, a fleet that
has not been analysed yet, and an over-restrictive filter all legitimately mean "no rows". Note that in a
datacenter where the v2 analysis pipeline has not yet run, every tenant legitimately reads as empty.
Unrecognized values for the enum-shaped parameters (sortBy, sortDirection,
riskLevels) are rejected with 400 and a body naming both a stable error code and the accepted
values — they are never silently ignored, because substituting a default would return plausibly-wrong
data in the right shape.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Query Params
int32

Zero-based page index. Absent or negative is treated as the first page.

int32

Rows per page; clamped downstream to AispmAgentReadSettings.MaxPageSize.

string

One of Mine.Portal.Module.Aispm.Services.AispmAgentSortField's member names, case-insensitively. Defaults to
LastDetectedAt.

string

AscendingDescending, or the short AscDescboth spellings are
accepted
(FE canvas F0BL02XC3N0). Case-insensitive. Defaults to Descending.


Added as aliases rather than by renaming the members, so a caller already sending the long form
keeps working — the tokens are matched exactly, so a rename would have made Descending a 400.

string

Free-text match over the agent name, its stable id and the device id. Case-insensitive.

RiskLevels
array of strings

Combined-risk bands to include, as Mine.Portal.Module.Aispm.Services.AispmCombinedRiskLevel member names.


Both multi-value styles are accepted?riskLevels=High&riskLevels=VeryHigh and

?riskLevels=High,VeryHigh — settled at the Pre-Intake gate, since different HTTP clients emit
different shapes and refusing one is a support ticket with no upside.

RiskLevels
Responses

Language
Credentials
Header
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json