Get a Conference Recording
Changed onRetrieves one voice-conference recording's metadata by conference SID and recording SID. Use List Conference Recordings to discover recording SIDs; Video Room recordings are separate media resources.
Request the recording URI with a .json extension to get the metadata. With .mp3, the URI responds with a 302 redirect to an MP3 version of the recording. Without an extension, the response follows the request's Accept header: application/json returns the metadata, and a generic value such as */* redirects to a WAV version. When the recording has no audio to return, for example because its status isn't completed, the audio URIs respond with 404 and an empty body.
Access follows the project's Protect Recording Media URLs setting, which new projects have turned on. When it's on, authenticate with your Project ID and an API token that has the Management scope; otherwise the request gets a 401. When it's off, anyone with the URI can retrieve the recording without authenticating. See Retrieve a Recording for details.
Request
- Base URLhttps://YOUR_SPACE.signalwire.com/api/laml/2010-04-01
- URLhttps://YOUR_SPACE.signalwire.com/api/laml/2010-04-01/Accounts/{AccountSid}/Conferences/{ConferenceSid}/Recordings/{Sid}.json
- AuthHTTP basic
Path parameters
Universal Unique Identifier.
The unique identifier for the account that created this conference.
Universal Unique Identifier.
The unique identifier for the conference this participant is in.
Universal Unique Identifier.
The unique identifier for the recording.
Response
The request has succeeded.
Example response
{
"api_version": "2010-04-01",
"channel": "1",
"channels": "1",
"date_created": "Tue, 25 Sep 2018 23:00:00 +0000",
"date_updated": "Wed, 26 Sep 2018 23:00:04 +0000",
"start_time": "Tue, 25 Sep 2018 23:00:00 +0000",
"end_time": "Wed, 26 Sep 2018 23:00:04 +0000",
"duration": 4,
"price": 0.0025,
"price_unit": "USD",
"uri": "/api/laml/2010-04-01/Accounts/720796a0-8ee9-4350-83bd-2d07a3121f1e/Conferences/43bb71ee-553f-4074-bb20-8e2747647cce/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"
}
}Changes
- breaking
removed the media type
application/jsonfor the response with the status - info
added the media type
text/plainfor the response with the status
- breaking
- info
removed the
StartConferenceRecordingenum value from the////response property for the response status
- info