Actions123
- Account Actions
- Account Agent Bot Actions
- Agent Actions
- Audit Log Actions
- Automation Rule Actions
- Canned Response Actions
- Contact Actions
- Contact Label Actions
- Conversation Actions
- Conversation Assignment Actions
- Custom Attribute Actions
- CSAT Survey Actions
- Custom Filter Actions
- Help Center Actions
- Inbox Actions
- Label Actions
- Conversation Label Actions
- Integration Actions
- Message Actions
- Profile Actions
- Report Actions
- Team Actions
- Webhook Actions
Conversation Assignment → Assign Agent
AI-generatedSummary
Assigns an agent to a conversation via the selected Chatwoot API type.
Inputs
- apiType — Select which API to use based on your role and use case. Defaults to the Application API for agent and admin conversation management. Options: Application API (for agents and admins), Client API (for end-users/customers), Platform API (for system administrators). Default: application
- conversationId (required) — The ID of the conversation to assign. Accepts a numeric conversation identifier.
- assignee_id (required) — The ID of the agent to assign the conversation to. Use 0 to unassign the conversation. Default: 0
Output shape
The operation returns the updated conversation assignment record from the Chatwoot API, reflecting the new agent assignment or unassignment status.
Setting assignee_id to 0 explicitly unassigns the conversation. The apiType parameter determines which Chatwoot API endpoint is used (application, client, or platform). All parameters are passed directly to the underlying Chatwoot Conversation Assignments endpoint.
Examples
Example 1: Assign agent ID 42 to conversation ID 123 using the Application API
apiType: application, conversationId: 123, assignee_id: 42