List discovered AI agents.

get

https://api.portal.saymine.com/api/aispm/v2/public/agents

One page of the AI agents discovered on your organization's devices, one row per agent per device. Filter, search, sort
and page with the query parameters. total is the number of rows matching the filters. No matches returns
{ "total": 0, "items": [] }, not a 404. An unrecognized sortBy, sortDirection or
riskLevels value is a 400 whose message names the accepted values. Authenticate with an API key.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Query Params

PageNumber

int32

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

PageSize

int32

Rows per page. Defaults to 25; the maximum is 1000 and a larger value is reduced to it. A value below 1 is raised
to 1.

SortBy

string

Field to sort by, case-insensitive: Name, Endpoint, Hostname, RiskLevel,
BusinessPurpose, FirstDetectedAt, LastDetectedAt. Defaults to LastDetectedAt. An unknown value is a
400 naming the accepted values.

SortDirection

string

Ascending or Descending (Asc/Desc also accepted), case-insensitive. Defaults to
Descending.

string

Case-insensitive text search over agent name, agent id, device id, hostname and vendor names.

RiskLevels

array of strings

Risk levels to include: VeryLow, Low, Medium, High, VeryHigh. Repeat the parameter or
comma-separate values. An unknown value is a 400.

RiskLevels

BusinessPurposes

array of strings

Business purposes to include, by display name. Repeat the parameter or comma-separate values; an unknown value matches
nothing. Values are combined with OR; different filters with AND.

BusinessPurposes

Vendors

array of strings

Vendors to include, by vendor id (for example anthropic.com) — the vendors an agent's components connect to. Same
multi-value rules as businessPurposes.

Vendors

Tools

array of strings

Tools to include, by display name. Same multi-value rules as businessPurposes.

Tools

IsCurrent

boolean

Only agents still reported by the latest scan of their AI tool on their device (true), or only those no longer
reported (false). Omit for both.

Hostnames

array of strings

Device hostnames to include, matched exactly. Same multi-value rules as businessPurposes.

Hostnames

Responses

Language

Credentials

Header

URL

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

200Success

400Bad Request

401Unauthorized