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

# setAiCoworkerProperties

Update agent-level fields (segments / workspaces / manager).

`setAiCoworkerProperties` is for non-versioned agent properties (workspaces, manager,
segments). It does NOT touch `availability_status` — pausing or resuming an agent goes
through `setAiCoworkerAvailability` instead. - `segments` — Which users can invoke this agent.

## Parameters

| Name              | Type       | Required | Description                                                                        |
| ----------------- | ---------- | -------- | ---------------------------------------------------------------------------------- |
| `agentId`         | integer    | Yes      |                                                                                    |
| `segments`        | integer\[] | No       | Segment IDs that can invoke this agent. Use \[-1] for all users.                   |
| `workspace_ids`   | integer\[] | No       | Workspaces the agent's shadow user should belong to. Empty/null → inherit-on-empty |
| `manager_user_id` | integer    | No       | Reporting manager for the agent's shadow user. Null → inherit-on-null (preserve    |
| `icon`            | object     | No       |                                                                                    |