Record your live event

You can record a live stream and create a video out of it. The recorded video will be available at the end of the live event as a VOD on Dailymotion.

You can activate an auto-record option, or monitor recording state in real time via the recording object on the livestream resource. The recorded video inherits metadata from the live event it is recorded from.

Activate the auto-record feature

To automatically record your live event from start to finish, set recording.auto_record to true on the livestream ID with a PATCH request on https://partner.api.dailymotion.com/v2/livestreams/<LIVESTREAM_ID>:

curl --request PATCH \
     --url https://api.dailymotion.com/v2/livestreams/<LIVESTREAM_ID> \
     --header 'accept: application/json' \
     --header 'authorization: Bearer ACCESS_TOKEN' \
     --header 'content-type: application/json' \
     --data '
{
  "recording": {
    "auto_record": true
  }
}
'

This call returns:

{
     "id": <LIVE_VIDEO_ID>,
     "live_auto_record": "true"
}

Monitor recording state

Once a recording is running, you can retrieve its current state and timestamps by querying the recording object. Make a GET request on https://api.dailymotion.com/v2/livestreams/<LIVESTREAM_ID>:

curl --request GET \
     --header "Authorization: Bearer <ACCESS_TOKEN>" \
     "https://api.dailymotion.com/v2/livestreams/<LIVESTREAM_ID>?fields=livestream_id,recording.status,recording.start_at,recording.end_at"

This call returns:

{
  "livestream_id": "<LIVESTREAM_ID>",
  "recording": {
    "status": "started",
    "start_at": "2025-06-10T14:00:00Z",
    "end_at": null
  }
}

Useful fields to manage live recordings

All recording-related fields are grouped under the recording nested object on the /v2/livestreams resource. Here is a reference of the fields available:

Default field: recording.auto_record is the only writable field. All other recording.* fields are read-only.