Agent/Transfer Conversation (to a Queue)
PUT /v1/agent/conversations/{id}/queue

Transfer Conversation (to a Queue)

The agent's half of a transfer, named and shaped exactly like the supervisor's route of the same path under /v1/admin, with one difference that matters: a supervisor may move any conversation, an agent may only hand on one they are **actually holding**. A former handler still sees the thread in their list and can read it, but a transfer from them is refused with 403. Records `reason: "transfer"` on the resulting lifecycle event, which is what lets the timeline tell an agent's handover from a supervisor's intervention. The former handler's unread counter is cleared with the handover, since nothing on it is waiting on them any more.

Base URL https://api.{cluster}.{platform}.voiger.io
Request · cURL
curl -X PUT https://api.{cluster}.{platform}.voiger.io/v1/agent/conversations/{id}/queue \
  -H "Cookie: sid=$VOIGER_SESSION" \
  -H "x-workspace-code: your-workspace-code" \
  -H "x-csrf-token: $CSRF_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
       "queue_id": "f47ac10b-58cc-4372-a567-0e02b2c3d479"
     }'

Parameters

x-workspace-code string required in header
x-csrf-token string required in header
id string required in path

Response

conversation
any