Error
held_by_desk
An outside desk is answering this conversation
| HTTP status | 409 |
|---|---|
| Retry | No: fix the request first |
| details | current (who holds it), desk (the desk's name) and takeBack (the request that takes it back). |
What happened
An outside desk is answering this conversation.
Why
The conversation is held by an outside support desk, which writes the replies, so a reply sent here would talk over it.
How to fix it
Take the conversation back first (PATCH /v1/conversations/{id} with handoff: accept, the same as "Take it back" in the dashboard), then send the reply.
Example response
{
"error": "held_by_desk",
"message": "An outside desk is answering this conversation.",
"requestId": "req-8f2c1d4b",
"retryable": false,
"docs": "https://docs.vlayers.ai/errors/held_by_desk"
}See Errors, retries and idempotency for how to handle errors in general.