Skip to main content
GuidesAPI Reference

Transfer a conversation

POST 
/rest/api/conversation/transfer

Transfers a conversation to another queue or to a specific agent, optionally attaching a note, attachments and tags.

Both conversation and transferee use a compound string syntax rather than plain UUIDs — see the field descriptions and the examples below.

Constraint worth knowing​

When conversation is supplied in the conversation:uuid:{uuid} form, the short agent:... form of transferee is not accepted, because the destination queue cannot be resolved from the request. Use queue:uuid:{queueUUID}/agent:uuid:{agentUUID} instead.

Notifications​

A status change caused by a transfer does not trigger a Conversation Status Update notification.

Request​

Responses​

The standard Converse 2.0 envelope. A rejected operation is also returned with HTTP 200 and status: "Failed" — check status, not only the HTTP status code.