listAiAgents

List AI agents accessible to the current user.

Lists AI Employee agents. Behavior depends on the caller’s role:

Admin (MANAGE_AGENT_SETTINGS): returns all agents regardless of publish_state or availability_status. Use this to manage the full agent inventory.

Parameters

Name	Type	Required	Description
`agent_type`	AiAgentTypeEnum[]	No	Filter by agent type. The server clamps results to [SYSTEM, CUSTOM] on this
`agent_subtype`	AiAgentSubtypeEnum	No	Filter by agent subtype label. Omit to return agents of any subtype.
`workspace_id`	integer	No	Filter to agents whose linked AI_EMPLOYEE user is a member of the given workspace.
`page`	integer	No	Page number for pagination Default: `1`.
`per_page`	integer	No	Number of items per page Default: `25`.
`sort_by`	AiAgentSortByEnum	No	Sort order for the returned page. Defaults to `UPDATED_AT_DESC` (most-recently-updated first) when omitted.
`publish_state`	AgentPublishStateFilterEnum[]	No	Filter by publish state. Comma-separated list of values narrows results to agents