Skip to main content

Stop audio playback

POST 
/calls/:call_control_id/actions/playback_stop

Stop audio being played on the call.

Expected Webhooks (see callback schema below):

  • call.playback.ended or call.speak.ended

Request

Path Parameters

    call_control_id stringrequired

    Unique identifier and token for controlling the call

Body

required

Stop audio playback request

    overlay boolean

    When enabled, it stops the audio being played in the overlay queue.

    stop string

    Default value: all

    Use current to stop the current audio being played. Use all to stop the current audio file being played and clear all audio files from the queue.

    client_state string

    Use this field to add state to every subsequent webhook. It must be a valid Base-64 encoded string.

    command_id string

    Use this field to avoid duplicate commands. Telnyx will ignore any command with the same command_id for the same call_control_id.

Responses

200: Successful response upon making a call control command.

default: Unexpected error

Callbacks

Request samples


curl -L 'https://api.telnyx.com/v2/calls/:call_control_id/actions/playback_stop' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer <TOKEN>' \
-d '{
"overlay": false,
"stop": "all",
"client_state": "aGF2ZSBhIG5pY2UgZGF5ID1d",
"command_id": "891510ac-f3e4-11e8-af5b-de00688a4901"
}'

Response samples


{
"data": {
"result": "ok"
}
}