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.
Authorizations
Query Parameters
Scope the listing to a single team. When omitted, returns agents owned by the authenticated user.
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.
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.
