Skip to main content
GET
List agents

Authorizations

Authorization
string
header
required

API key obtained from the dashboard or GET /user/api-key

Query Parameters

include
enum<string>

grants-summary adds a grantsSummary object to each agent.

Available options:
grants-summary

Response

List of agents — plain, or with grantsSummary when include=grants-summary was sent.

id
string
name
string
identifier
string
accessToken
string

The agent's gateway access token (aoc_…). Returned by GET /agents and GET /agents/default; not included in the POST /agents response — read it from the list or regenerate it.

isDefault
boolean
secretMode
enum<string>

Deprecated — always selective on current servers (agents use only what their grants provide). Retained for wire compatibility; scheduled for removal.

Available options:
all,
selective
createdAt
string<date-time>