Changes the status of the recording to paused

POST /2010-04-01/Accounts/{AccountSid}/Conferences/{ConferenceSid}/Recordings/{Sid}.json

Recordings of conferences

Changes the status of the recording to paused, stopped, or in-progress. Note: To use Twilio.CURRENT, pass it as recording sid.

Path parameters

AccountSid string Required

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

The Conference SID that identifies the conference associated with the recording to update.
Sid string Required

The Twilio-provided string that uniquely identifies the Conference Recording resource to update. Use Twilio.CURRENT to reference the current active recording.

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 create 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 as an integer
- 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 string | 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.
- uri string | null
  
  The URI of the resource, relative to https://api.twilio.com

POST /2010-04-01/Accounts/{AccountSid}/Conferences/{ConferenceSid}/Recordings/{Sid}.json

curl \
 -X POST https://api.twilio.com/2010-04-01/Accounts/{AccountSid}/Conferences/{ConferenceSid}/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": "string",
  "price_unit": "string",
  "sid": "string",
  "source": "DialVerb",
  "start_time": "string",
  "status": "in-progress",
  "uri": "string"
}

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": "string",
  "price_unit": "string",
  "sid": "string",
  "source": "DialVerb",
  "start_time": "string",
  "status": "in-progress",
  "uri": "string"
}