Changes the status of the recording to paused, stopped, or in-progress. Note: Pass `Twilio.CURRENT` instead of recording sid to reference current active recording.
A Recording resource represents the recording associated with a voice call, conference, or SIP Trunk.
Changes the status of the recording to paused, stopped, or in-progress. Note: Pass Twilio.CURRENT
instead of recording sid to reference current active recording.
Path parameters
-
The SID of the Account that created the Recording resource to update.
Minimum length is
34
, maximum length is34
. Format should match the following pattern:^AC[0-9a-fA-F]{32}$
. -
The Call SID of the resource to update.
Minimum length is
34
, maximum length is34
. Format should match the following pattern:^CA[0-9a-fA-F]{32}$
. -
The Twilio-provided string that uniquely identifies the Recording resource to update.
Body
-
The status of the recording. Can be:
processing
,completed
andabsent
. For more detailed statuses on in-progress recordings, check out how to Update a Recording Resource.Values are
in-progress
,paused
,stopped
,processing
,completed
, orabsent
. -
Whether to record during a pause. Can be:
skip
orsilence
and the default issilence
.skip
does not record during the pause period, whilesilence
will replace the actual audio of the call with silence during the pause period. This parameter only applies when settingstatus
is set topaused
.
curl \
--request POST 'https://api.twilio.com/2010-04-01/Accounts/{AccountSid}/Calls/{CallSid}/Recordings/{Sid}.json' \
--user "username:password" \
--header "Content-Type: application/x-www-form-urlencoded" \
--data 'Status=paused&PlayBeep=true&PauseBehavior=skip'
{"Status"=>"paused", "PlayBeep"=>true, "PauseBehavior"=>"skip"}
{
"sid": "REaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"uri": "/2010-04-01/Accounts/ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Calls/CAaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Recordings/REaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa.json",
"price": null,
"track": "both",
"source": "StartCallRecordingAPI",
"status": "paused",
"call_sid": "CAaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"channels": 2,
"duration": null,
"error_code": null,
"price_unit": null,
"start_time": "Fri, 14 Oct 2016 21:56:34 +0000",
"account_sid": "ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"api_version": "2010-04-01",
"date_created": "Fri, 14 Oct 2016 21:56:34 +0000",
"date_updated": "Fri, 14 Oct 2016 21:56:36 +0000",
"conference_sid": null,
"encryption_details": null
}