Actions62
- Agent Actions
- Agent Version Actions
- Board Actions
- Call Actions
- Channel Actions
- Contact Actions
- Conversation Actions
- Credit Actions
- Event Actions
- Phone Number Actions
- Tag Actions
- Task Actions
- Voice Actions
- WhatsApp Actions
Conversation → Update
AI-generatedSummary
Update a specified conversation's assignment and status in ContactShip by providing the conversation ID and optional fields to change.
Inputs
- Conversation ID (required) — The unique identifier of the conversation (thread) to update, as returned in 'thread_id' when a WhatsApp message is sent.
- Assign To — Select who will handle the conversation: assign to an AI agent, a user, nobody, or keep the current assignee.
- User — Specify the organization member to assign the conversation to if 'Assign To' is set to 'User'.
- AI Agent ID — Specify the ContactShip text agent ID if 'Assign To' is set to 'AI Agent'.
- Update Fields — Optional fields to update on the conversation, including its status (open or closed).
Output shape
a single updated conversation record
Returns the updated conversation object reflecting the changes. Changing assignees may be restricted by organizational policies and require inbox changes if protected.
Examples
Example 1: Update the status of a conversation to 'closed' and assign it to a specific user
Provide the conversation ID; set 'Assign To' to 'User' and specify the user; under update fields, set status to 'closed'.