Make an Internal Call

Make an internal call between two extensions.

Send the request to make extension A dial extension B. Extension A will ring first, extension B will ring after extension A picks up the call.

If autoanswer is set to yes, extension A (the calling party) will hear the ring back tone, extension B (the called party) will hear the ringing.

Endpoint

POST /api/v1.1.0/extension/dial_extension?token={token}

Request Parameters

Name Importance Type Description
caller Required String The caller extension.
callee Required String The called extension.
autoanswer Optional String Whether to auto answer the call or not. This parameter requires the SIP phone to support.
  • yes
  • no

Response Parameters

Name Type Description
callid String A unique Identifier for the call.

Examples

Request Example
POST /api/v1.1.0/extension/dial_extension?token=1e3b3ebb6a974cb42ed31de5413df52d HTTP/1.1
Content-Type:application/json; charset=utf-8
Host: api.yeastarcloud.com
{
    "caller": "1005",
    "callee": "1006",
    "autoanswer": "no"
}
Response Example
HTTP/1.1 200 OK
Access-control-allow-origin: *
Access-control-allow-methods: GET, POST, OPTIONS, PUT, DELETE
{
    "status": "Success",
    "callid": "1547397927.431"
}