Update a Recording

POST 
/Accounts/:AccountSid/Calls/:CallSid/Recordings/:Sid

Pause, resume or stop a Recording. You can control what happens while recording is paused (replace pause with silence or skip it).

Permissions

The API token must include the following scopes: Voice.

Request

Path Parameters

AccountSid uuidrequired

The unique identifier for the account that is associated with this recording.

CallSid uuidrequired

The unique identifier for the call that is associated with this recording.

Sid uuidrequired

The unique identifier for the recording.

application/x-www-form-urlencoded

Body

Statusstringrequired
The status of the recording.
Possible values: [paused, in-progress, stopped]
Example: stopped
PauseBehaviorstring
What to do while recording is paused.
Possible values: [skip, silence]
Example: silence

Responses

200

OK

application/json

Schema

Schema

account_siduuid
The unique identifier for the account that is associated with this recording.
Example: 720796a0-8ee9-4350-83bd-2d07a3121f1e
api_versionstring
The version of the SignalWire API.
Example: 2010-04-01
call_sidstring
The unique identifier for the call that is associated with this recording.
Example: 43bb71ee-553f-4074-bb20-8e2747647cce
conference_sidstring
The unique identifier for the conference that is associated with this recording.
Example: 2071320d-ee82-4578-84e0-379fb227eb77
channelsinteger
The number of channels in a recording. Possible values are 1 or 2.
Possible values: [1, 2]
Example: 1
date_createdstring
The date, in RFC 2822 format, this recording was created.
Example: Tue, 25 Sept 2018 23:00:00 +0000
date_updatedstring
The date, in RFC 2822 format, this recording was updated.
Example: Wed, 26 Sept 2018 23:00:04 +0000
end_timestring
The time, in RFC 2822 format, this recording endded.
Example: Wed, 26 Sept 2018 23:00:04 +0000
pricestring
The cost for the recording.
Example: -0.0025
price_unitstring
The currency of the price of the recording.
Example: USD
durationstring
The length, in seconds, of the recording.
Example: 4
sidstring
The unique identifier for the recording.
Example: 19e436af-5688-4307-b03b-bdb2b42b8142
sourcestring
How the recording was made.
Possible values: [DialVerb, Conference, OutBoundApi, Trunking, RecordVerb, StartCallRecordingApi, StartConferenceRecording]
Example: DialVerb
statusstring
The status of the recording.
Possible values: [paused, in-progress, stopped]
Example: stopped
error_codestring
Further details about a failed recording.
Example: null
uristring
The URI of the recording.
Example: /api/laml/2010-04-01/Accounts/720796a0-8ee9-4350-83bd-2d07a3121f1e/Calls/058a869c-d387-4bef-8e62-6b0bc0895bed/Recordings/19e436af-5688-4307-b03b-bdb2b42b8142.json

subresource_uris

object

Subresource URIs

transcriptionsstring

Example: /api/laml/2010-04-01/Accounts/720796a0-8ee9-4350-83bd-2d07a3121f1e/Recordings/19e436af-5688-4307-b03b-bdb2b42b8142/Transcriptions.json

Example (from schema)

{
  "account_sid": "720796a0-8ee9-4350-83bd-2d07a3121f1e",
  "api_version": "2010-04-01",
  "call_sid": "43bb71ee-553f-4074-bb20-8e2747647cce",
  "conference_sid": "2071320d-ee82-4578-84e0-379fb227eb77",
  "channels": 1,
  "date_created": "Tue, 25 Sept 2018 23:00:00 +0000",
  "date_updated": "Wed, 26 Sept 2018 23:00:04 +0000",
  "end_time": "Wed, 26 Sept 2018 23:00:04 +0000",
  "price": "-0.0025",
  "price_unit": "USD",
  "duration": "4",
  "sid": "19e436af-5688-4307-b03b-bdb2b42b8142",
  "source": "DialVerb",
  "status": "stopped",
  "error_code": "null",
  "uri": "/api/laml/2010-04-01/Accounts/720796a0-8ee9-4350-83bd-2d07a3121f1e/Calls/058a869c-d387-4bef-8e62-6b0bc0895bed/Recordings/19e436af-5688-4307-b03b-bdb2b42b8142.json",
  "subresource_uris": {
    "transcriptions": "/api/laml/2010-04-01/Accounts/720796a0-8ee9-4350-83bd-2d07a3121f1e/Recordings/19e436af-5688-4307-b03b-bdb2b42b8142/Transcriptions.json"
  }
}