Changes the status of the recording to paused

POST /2010-04-01/Accounts/{AccountSid}/Calls/{CallSid}/Recordings/{Sid}.json

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

AccountSid string Required

The SID of the Account that created the Recording resource to update.
CallSid string Required

The Call SID of the resource to update.
Sid string Required

The Twilio-provided string that uniquely identifies the Recording resource to update.

Body

PauseBehavior string

Whether to record during a pause. Can be: skip or silence and the default is silence. skip does not record during the pause period, while silence will replace the actual audio of the call with silence during the pause period. This parameter only applies when setting status is set to paused.
Status string Required

The new status of the recording. Can be: stopped, paused, in-progress.

Values are in-progress, paused, stopped, processing, completed, or absent.

Responses

200

OK
Hide response attributes Show response attributes object
- account_sid string | null
  
  The SID of the Account that created the resource
  
  Minimum length is 34, maximum length is 34. Format should match the following pattern: ^AC[0-9a-fA-F]{32}$.
- api_version string | null
  
  The API version used to make the recording
- call_sid string | null
  
  The SID of the Call the resource is associated with
  
  Minimum length is 34, maximum length is 34. Format should match the following pattern: ^CA[0-9a-fA-F]{32}$.
- channels integer | null
  
  The number of channels in the final recording file
- conference_sid string | null
  
  The Conference SID that identifies the conference associated with the recording
  
  Minimum length is 34, maximum length is 34. Format should match the following pattern: ^CF[0-9a-fA-F]{32}$.
- date_created string(date-time-rfc-2822) | null
  
  The RFC 2822 date and time in GMT that the resource was created
- date_updated string(date-time-rfc-2822) | null
  
  The RFC 2822 date and time in GMT that the resource was last updated
- duration string | null
  
  The length of the recording in seconds
- encryption_details
  
  How to decrypt the recording.
- error_code integer | null
  
  More information about why the recording is missing, if status is absent.
- price number | null
  
  The one-time cost of creating the recording.
- price_unit string(currency) | null
  
  The currency used in the price property.
- sid string | null
  
  The unique string that identifies the resource
  
  Minimum length is 34, maximum length is 34. Format should match the following pattern: ^RE[0-9a-fA-F]{32}$.
- source string | null
  
  How the recording was created
  
  Values are DialVerb, Conference, OutboundAPI, Trunking, RecordVerb, StartCallRecordingAPI, or StartConferenceRecordingAPI.
- start_time string(date-time-rfc-2822) | null
  
  The start time of the recording, given in RFC 2822 format
- status string | null
  
  The status of the recording
  
  Values are in-progress, paused, stopped, processing, completed, or absent.
- track string | null
  
  The recorded track. Can be: inbound, outbound, or both.
- uri string(uri) | null
  
  The URI of the resource, relative to https://api.twilio.com

POST /2010-04-01/Accounts/{AccountSid}/Calls/{CallSid}/Recordings/{Sid}.json

curl \
 -X POST https://api.twilio.com/2010-04-01/Accounts/{AccountSid}/Calls/{CallSid}/Recordings/{Sid}.json \
 --user "username:password" \
 -H "Content-Type: application/x-www-form-urlencoded" \
 -d 'PauseBehavior=string&Status=in-progress'

Request example

{
  "PauseBehavior": "string",
  "Status": "in-progress"
}

Request examples

{
  "PauseBehavior": "string",
  "Status": "in-progress"
}

Response examples (200)

{
  "account_sid": "string",
  "api_version": "string",
  "call_sid": "string",
  "channels": 42,
  "conference_sid": "string",
  "date_created": "string",
  "date_updated": "string",
  "duration": "string",
  "error_code": 42,
  "price": 42.0,
  "price_unit": "string",
  "sid": "string",
  "source": "DialVerb",
  "start_time": "string",
  "status": "in-progress",
  "track": "string",
  "uri": "https://example.com"
}

Response examples (200)

{
  "account_sid": "string",
  "api_version": "string",
  "call_sid": "string",
  "channels": 42,
  "conference_sid": "string",
  "date_created": "string",
  "date_updated": "string",
  "duration": "string",
  "error_code": 42,
  "price": 42.0,
  "price_unit": "string",
  "sid": "string",
  "source": "DialVerb",
  "start_time": "string",
  "status": "in-progress",
  "track": "string",
  "uri": "https://example.com"
}