latestOpenAPI 3.0.0MIT2026-08-101483217.9 KB

a59ac1ee7b2c

Calls

Manage Call with `callLeg`

This method is used to manage ongoing, connected calls. This method is only used when using the PlayFiles and Say instructions in the request body. This method uses SVAML in the request body to perform various tasks related to the call. For more information about SVAML, see the Callback API documentation.

Note: You can only use this method for calls that originate from or terminate to PSTN or SIP networks.

patch/calling/v1/calls/id/{callId}/leg/{callLeg}

Request body

Example request

{
  "instructions": [
    {
      "ids": [
        "#ssml[Thank you for calling Sinch!]"
      ],
      "locale": "en-US"
    }
  ],
  "action": {
    "locale": "en-US",
    "introPrompt": "#tts[Welcome]",
    "holdPrompt": "#tts[Thank you for your patience, your call is very important to us.]",
    "maxDuration": 180
  }
}

Response

A success response, or an Error.