Legs

Transfer a SIP leg via REFER (asynchronous)

Asynchronously transfers a SIP leg. The HTTP call returns 202 as soon as the request is validated; the REFER is sent in the background and its outcome is surfaced through leg.transfer_initiated / leg.transfer_progress / leg.transfer_completed / leg.transfer_failed events. Blind transfer when replaces_leg_id is omitted; attended transfer when present (the named leg's dialog identity is embedded as a Replaces parameter per RFC 3891). On terminal 2xx the leg (and the replaces leg, if any) is hung up automatically.

post/legs/{id}/transfer

Request body

targetstring required

SIP URI to transfer the call to (e.g. "sip:bob@example.com").

replaces_leg_idstring

ID of an existing connected SIP leg whose dialog should be replaced (attended transfer). Omit for blind transfer.

Response

Transfer request accepted for processing

Changes

Changed in 2 of the 67 revisions of this API.11

Apr 14, 2026863dba60b82f1See the full diff
- ○
  endpoint added
  endpoint-added
Mar 26, 2026d09c97c6ca8c1See the full diff
- ▲
  api path removed without deprecation
  api-path-removed-without-deprecation
This revision also has 40 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

Full history