Error
handover_unsupported
This conversation cannot have that controller
| HTTP status | 409 |
|---|---|
| Retry | No: fix the request first |
| details | channel, 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
{
"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.