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 the max page size.

string

Sort field (a Mine.Portal.Module.Aispm.Services.AispmAgentSortField member name, case-insensitive); defaults to LastDetectedAt.

string

AscendingDescending, or the short AscDesc — both spellings accepted, case-insensitive. Defaults to Descending.

string

Free-text substring match (case-insensitive) over agent name, stable id, device id, hostname, and connected/harness vendor names.

RiskLevels
array of strings

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

RiskLevels
BusinessPurposes
array of strings

Business purposes to include, as the display-name values the /facets endpoint emits.

BusinessPurposes
Vendors
array of strings

Vendors (catalog service ids an agent's components connect to) to include, as the /facets values.

Vendors
Tools
array of strings

Tools (tool-kind component display names) to include, as the /facets values.

Tools
Hostnames
array of strings

Device hostnames to include, matched exactly against Device.Hostname.

Hostnames
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