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.
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