Skip to content

Creation & Management#

Start / Stop recording#

Recordings are started from the meeting view by a participant with the canRecord permission (see Predefined roles). The room must have recording enabled in its configuration.

While the recording is active, all participants in the meeting will see an indicator in the bottom left corner.

Recording indicator shown to participants during the meeting Recording indicator shown to participants during the meeting

To stop the recording, a participant with the canRecord permission must simply click the "Stop recording" button. The recording is then automatically saved on the OpenVidu Meet server.

Stop recording button in the meeting toolbar Stop recording button in the meeting toolbar

Starting and stopping recordings via REST API

Recordings can also be started and stopped with the REST API. There must be an active meeting in the target room — starting a recording in a room with no ongoing meeting returns an error. When starting a recording via the API, you may also override the room's default layout and encoding for that specific recording.

Managing recordings#

A saved recording can be listed, played, shared, downloaded and deleted (individually or in bulk). All of these actions are available — subject to your recording permissions — from any of the places where recordings appear in the app:

  • The general "Recordings" page, which lists every recording you can access.

Recordings page listing every accessible recording Recordings page listing every accessible recording

  • The detail recording page — accessed from the general "Recordings" page when clicking a recording — which shows the recording's metadata and a player displaying it.

Recording detail page with metadata and actions Recording detail page with metadata and actions

Recordings tab of a room's detail page Recordings tab of a room's detail page

  • The room recordings view, reachable from within a meeting (and from the lobby view before joining).

Recordings view listing the recordings of the room Recordings view listing the recordings of the room

  • The display recording view — accessed when clicking the play button for a recording — which displays the recording.

Recording playback view Recording playback view

Sharing recordings#

When you create a shareable link for a recording, you choose who can access it:

  • OpenVidu Meet users: any logged-in OpenVidu Meet user can view the recording — even if they have no recording permissions in that room, or no access to the room at all.
  • Anyone: any individual with the link can view it without logging in. This option is available only when the room has anonymous recording sharing enabled.

REST API reference#

All of these operations can also be performed programmatically with the OpenVidu Meet REST API. See the REST API specification for the full list of available endpoints, request bodies and response schemas.

Operation HTTP Method Reference
Start a recording POST Reference
Stop a recording POST Reference
Get all recordings GET Reference
Download recordings GET Reference
Bulk delete recordings DELETE Reference
Get a recording GET Reference
Delete a recording DELETE Reference
Get recording media GET Reference
Get recording URL GET Reference