Error

handover_unsupported

This conversation cannot have that controller

HTTP status409
RetryNo: fix the request first
detailschannel, and reason when the agent is the cause.

What happened

This conversation cannot have that controller.

Why

The conversation cannot be handed to who you asked for: a conversation on a share link whose owner has not allowed take-over cannot go to the API or a person (details.reason: share_link_takeover_off), and an agent that answers from your own code (onMessage) cannot be handed the conversation back (details.reason: direct_mode_agent).

How to fix it

Keep the conversation with its current controller (your code, a person, or the API).

Example response

HTTP 409
{
  "error": "handover_unsupported",
  "message": "This conversation cannot have that controller.",
  "requestId": "req-8f2c1d4b",
  "retryable": false,
  "docs": "https://docs.vlayers.ai/errors/handover_unsupported"
}

See Errors, retries and idempotency for how to handle errors in general.

On this page