Requests & TicketsAI Employee Agents

setAiAgentProperties

View as Markdown

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

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

Parameters

NameTypeRequiredDescription
agentIdintegerYes
segmentsinteger[]NoSegment IDs that can invoke this agent. Use [-1] for all users.
workspace_idsinteger[]NoWorkspaces the agent’s shadow user should belong to. Empty/null → inherit-on-empty
manager_user_idintegerNoReporting manager for the agent’s shadow user. Null → inherit-on-null (preserve
iconobjectNo