List agents
Returns all agents in the current project.
Pass include=grants-summary to also get each agent’s granted credentials (which app connections and secrets are attached) in one request. Any other include value is rejected with 422.
Authorizations
API key obtained from the dashboard or GET /user/api-key
Query Parameters
grants-summary adds a grantsSummary object to each agent.
grants-summary Response
List of agents — plain, or with grantsSummary when include=grants-summary was sent.
- Agents · object[]
- Agents with grants summary · object[]
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.
Deprecated — always selective on current servers (agents use only what their grants provide). Retained for wire compatibility; scheduled for removal.
all, selective