Source: https://manu-tests-all-orgs.docs-staging.pageloop.ai/mcp-tools/requests-tickets/other/list-ai-coworkers

# 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_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                           |