Get recordings
This endpoint enables you to get a list of all the recordings in your account, the recording contains the audio and video of each participant (if they have their camera and microphone enabled) during the meeting, and any content shared during the meeting.
Before we start
Meetings are not recorded by default. To record a meeting, you must enable the recording feature during the meeting. It can be achieved by either clicking the toolbar button 'Record' at the interface or by invoking the toogleRecording()
method on the Video Conference.
How to use
You can use the following cURL to obtain a response on the endpoint:
curl --location --request GET https://nodeapi.superviz.com/recording \
--header 'Content-Type: application/json' \
--header "Authorization: Bearer ${YOUR TOKEN}" \
--header "apiKey: ${YOUR PASSPHRASE}"
HTTP Request
GET https://nodeapi.superviz.com/recording?roomId={ROOM_ID}&meetingId={MEETING_ID}
You can filter the recordings by the roomId
or the meetingId
.
Name | Description |
---|---|
roomId | When providing the roomId , it will return all the recordings made in the room. |
meetingId | When providing the meetingId , it will return the recordings made in a specific meeting. |
Headers
When using this endpoint, you need to provide the Authorization Bearer token and the passphrase. The following headers are required:
Name | Description |
---|---|
Authorization | Required. You must utilize the authentication token. |
apikey | Required. You must utilize the Developer Token that can be found on the developer page. By utilizing this key, we will define whether to get data from the developer or the production environment. |
Response
Status code 200 will indicate that the request was successful. The response will be a list of recordings in JSON format with our pagination schema and include the following fields:
Name | Type | Description |
---|---|---|
uuid | string | This field contains the unique identification of the recording. |
url | string | This field contains a temporary URL where the recording is stored and can be used to download or visualize it. We do not recommend saving this information on your end since the URL can expire. |
roomId | string | This field contains the unique identification of the room during which the recording was made. |
status | string | This field contains the status of the recording. The possible values are processing and available . The URL of the recording will be available after about 5 minutes of the end of the recording. |
meetingId | string | This field contains the unique identification of the meeting during which the recording was made. Remember that one meeting can contain multiple recordings. |
createdAt | string | This field contains the date and time when the recording was created. |
Example:
[
{
"uuid": "RECORDING_ID",
"url": "https://.../",
"roomId": "ROOM_ID",
"status": "processing",
"meetingId": "MEETING_ID",
"createdAt": "2024-05-13T17:14:00.941Z"
}
]