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

# createAiCoworker

Create an AI Coworker.

Creates a new AI Coworker with an initial DRAFT version. **Lifecycle:**

1. Call `publishAiCoworker(agentId)` after creation or draft updates
2.

## Parameters

| Name                      | Type              | Required | Description                                                                                                              |
| ------------------------- | ----------------- | -------- | ------------------------------------------------------------------------------------------------------------------------ |
| `agent_type`              | object            | No       |                                                                                                                          |
| `agent_subtype`           | object            | No       |                                                                                                                          |
| `name`                    | string            | Yes      |                                                                                                                          |
| `description`             | string            | No       |                                                                                                                          |
| `prompt_config`           | object            | No       |                                                                                                                          |
| `tools`                   | AgentToolDto\[]   | No       |                                                                                                                          |
| `skill_ids`               | integer\[]        | No       |                                                                                                                          |
| `skills_inline`           | InlineSkillDto\[] | No       | Agent-owned inline skills. Full-array replacement semantics.                                                             |
| `capabilities`            | string            | Yes      | Free-form description of what the agent can do; seeds future identity/goal generation. Versioned. Required and non-empty |
| `adapter_type`            | object            | No       |                                                                                                                          |
| `adapter_config_template` | object            | No       | Per-adapter free-form configuration template. Snapshotted into each AA run's adapter\_config                             |
| `max_concurrent_runs`     | integer           | No       | Per-agent concurrency cap. Omitted or explicit-null → leave the column NULL; the drainer                                 |
| `workspace_ids`           | integer\[]        | No       | Workspaces to add the agent's shadow user to. Live-write to workspace\_members in the same                               |
| `manager_user_id`         | integer           | No       | Reporting manager for the agent's shadow user. Live-write to User.manager. Null →                                        |
| `icon`                    | object            | No       |                                                                                                                          |