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

# getAiCoworker

Get an AI Coworker.

Returns the full agent definition with v1 state-machine fields. Behavior depends on the caller's role:

* **Admin** (MANAGE\_AGENT\_SETTINGS): returns the full agent. - **Non-admin**: returns the agent with segment access enforcement.

## Parameters

| Name      | Type    | Required | Description |
| --------- | ------- | -------- | ----------- |
| `agentId` | integer | Yes      |             |