Other
listAiCoworkers
List AI Coworkers accessible to the current user.
Lists AI Coworkers. Behavior depends on the caller's role:
- Admin (MANAGE_AGENT_SETTINGS): returns all agents regardless of
publish_stateoravailability_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 |