---
title: "Transfer a live call to another number or user"
method: POST
path: "/channels/{channelId}/events/transfer"
tags: ["channels"]
---

# Transfer a live call to another number or user

`POST /channels/{channelId}/events/transfer`

Transfers the live call on the specified channel to another phone number or user. The current participant is disconnected and the call is redirected to the transfer destination. This is a blind (cold) transfer — the call is forwarded immediately without announcing the transfer to the destination.

The `channelId` identifies a specific participant's leg in the call. Use `POST /calls/current` to discover active channel IDs. The transfer destination is specified in the request body.

**Permission:** `Calls Write` required.

**Monitoring:** **Required.** This is a live call supervisory control. Returns `401 Unauthorized` if Monitoring is OFF on your API key.

## Path parameters

- `channelId` string, required

## Request body

- EventTransfer
  - `phone_number` integer

## Response `201`

Successfully processed — the call transfer has been initiated.

## Other responses

- `400` — Invalid request body or channel ID format.
- `401` — Unauthorized — missing or invalid token, or Monitoring is not enabled on your API key.
- `404` — Channel not found — no active call channel matches the provided ID.
- `500` — Internal server error.
- `502` — Service temporarily unavailable — please retry later.

---

[API](https://skmtc.net/ringover/apis/ringover-public-api.md) · [All operations](https://skmtc.net/ringover/apis/ringover-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ringover/ringover-public-api/revisions/9da73dd2f99e/schema)