---
title: "Transfer conversation"
method: PUT
path: "/beta/conversations/{conversationId}/transfer/queue"
tags: ["Conversations", "Chatbots"]
---

# Transfer conversation

`PUT /beta/conversations/{conversationId}/transfer/queue`

Transfer a conversation to a target queue.

## Path parameters

- `conversationId` integer, required

## Request body

- TransferConversationInput
  - `queueId` string, uuid, required — The target queue for the conversation transfer
  - `userId` string, uuid — An optional agent/admin to originate the transfer of the conversation

## Response `204`

The conversation was successfully transferred to the target queue

## Other responses

- `400` — Invalid value for: path parameter conversationId, Invalid value extracted from request context, Invalid value for: body, User not found, User is not agent/admin, Queue does not exist
- `404` — An entity in this request could not be found
- `500` — Internal failure during request processing

---

[API](https://skmtc.net/dixa/apis/dixa-api.md) · [All operations](https://skmtc.net/dixa/apis/dixa-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/dixa/dixa-api/versions/041e058483f0/schema)
