Call Transfer

If an extension is in an active call, you can use this interface to transfer the call to another extension, IVR, queue, ring group, or an external number.

Endpoint

POST /api/v1.1.0/calltransfer?token={token}

Request Parameters


Name	Importance	Type	Description
`callid`	Required	String	The call ID.
`transferor`	Required	String	Which call party will transfer the call. Note: After the call is transferred, the transferor automatically hangs up the call.
`transferto`	Required	String	Transfer to this number.
`fromext`	Optional	String	If transferring the call to an external number, which extension's call permission will be applied.

Examples

Request Example

POST /api/v1.1.0/calltransfer?token=277ac400357b509b4a587ff2157f7ad5 HTTP/1.1
Content-Type:application/json; charset=utf-8
Host: api.yeastarcloud.com
{
    "callid": "1550576451.121",
    "transferor": "1001",
    "transferto": "1003",
    "fromext": ""
}

Response Example

HTTP/1.1 200 OK
Access-control-allow-origin: *
Access-control-allow-methods: GET, POST, OPTIONS, PUT, DELETE
{
    "status": "Success",
    "callid": "1550576451.121"
}