List agents
List agents the caller has access to. Filter by team, search by name, or narrow to agents that use a specific tool or trigger. Results can be sorted with sort_order and paginated by sending page_size and/or cursor. Send summary=true to receive the lightweight AgentSummary shape instead of each agent’s whole configuration.
Authorizations
Query Parameters
Scope the listing to a single team. Get team IDs from List teams. When omitted, returns agents owned by the authenticated user; their team_id is the user's own ID.
Case-insensitive substring match against the agent name.
Filter to agents created by this user ID.
When true, only returns agents that have at least one active trigger configured.
Filter to agents that use the specified MCP server as a tool.
Filter to agents that use the specified saved flow as a tool.
Sort order for the listing. Defaults to newest first.
newest, oldest, name_asc, name_desc When true, populates last_used_at on each agent with the timestamp of its most recent session.
When true, populates last_updated_at on each agent with the timestamp of its most recent configuration change.
When true, each item is an AgentSummary (identity, model, creator and activity fields) rather than the whole Agent configuration. Drops system_prompt, tools, resources and metadata, which make up most of a large team's list payload. Combine with page_size to browse a large team in small pages.
Number of agents per page. Sending page_size or cursor opts into cursor pagination; requests that send neither return the full list.
1 <= x <= 100Opaque cursor from a previous response's next_cursor. Pass it to fetch the next page.
Response
Agents matching the provided filters.
Agent items by default; AgentSummary items when the request sent summary=true.
An agent and its whole configuration. Single-agent retrieve, create and update return this shape; the list endpoint does not populate the inlined collections, abilities or version. Collection-specific writes return their own result shapes.
- Option 1
- Option 2
Cursor for the next page. Present only on paginated requests; null when there are no more results.
null