Source: https://manu-tests-all-orgs.docs-staging.pageloop.ai/mcp-tools/requests-tickets/other/set-ai-coworker-properties

# 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       |                                                                                    |
| `avatar_attachment_id` | integer    | No       | Attachment id of the agent's new avatar. PATCH semantics: absent → no change;      |