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,completedandabsent. 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:
skiporsilenceand the default issilence.skipdoes not record during the pause period, whilesilencewill replace the actual audio of the call with silence during the pause period. This parameter only applies when settingstatusis 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
}