> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://developer-test.atomicwork.com/llms.txt.
> For full documentation content, see https://developer-test.atomicwork.com/llms-full.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://developer-test.atomicwork.com/_mcp/server.

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