Error

held_by_desk

An outside desk is answering this conversation

HTTP status409
RetryNo: fix the request first
detailscurrent (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

HTTP 409
{
  "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.

On this page