Actions14
- Message Actions
- Conversation Actions
- Contact Actions
- Agent Actions
Conversation → Handover
AI-generatedSummary
Unassign the owner and disable AI for a specific conversation by performing a handover, optionally moving the conversation to a specified column.
Inputs
- Conversation ID (required) — The UUID of the conversation to handover.
- Target Column — The destination column to move the conversation after handover. Defaults to 'inbox' if not specified.
- User ID (for Audit) — The user identifier for audit logging the handover action. Defaults to 'n8n'.
Output shape
a single JSON object representing the API response for the handover action
Sends a POST request to the Cortex API endpoint for conversation handover. The response may vary depending on API implementation and is returned directly. If the 'Target Column' is 'inbox' or not set, the column_id field is omitted from the request body. Errors throw unless 'Continue On Fail' is enabled, in which case error messages are returned as JSON objects.
Examples
Example 1: Perform a handover on conversation with ID 1234, moving it to the 'support' column and logging as user 'agent007'
Set 'Conversation ID' to '1234'; select 'support' for 'Target Column'; specify 'agent007' for 'User ID (for Audit)'.