Cortex icon

Cortex

Interact with Cortex API

Conversation → Handover

AI-generated

Summary

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)'.

Links

Discussion