This endpoint allows you to update the settings of a live stream, whether it is scheduled, currently live, or hasn't started yet. You can change key parameters such as the scheduled start time (scheduled_at) or enable DVR (active_dvr) so that your viewers can rewind the live stream while it’s happening. Updates made through this endpoint will immediately reflect on the live object, and depending on what is changed, the updates may also impact how the live behaves on the player and dashboard. For instance, modifying the scheduled start time can affect when the live will appear as “Upcoming” in the embed player and internal dashboards. You are free to call this endpoint as many times as needed during the lifecycle of a live. It is especially useful for adjusting the timing of scheduled streams, enabling DVR functionality before or during a live event, or programmatically managing lives via your own platform. You only need to send the fields you wish to update — any omitted fields will remain unchanged.
| Parameter | Type | Description |
|---|---|---|
| live_id | string | The ID of the live you want to update. Must be passed in the URL path. |
| title | string | Title of the live stream. This will be displayed in the dashboard, player, and shared pages. |
| scheduled_at | string | The scheduled start time for the live, in the format YYYY-MM-DDTHH:mm:ss (ISO 8601) |
| folder_id | string | The ID of the folder where the live should be moved. Useful for organizing lives in your dashboard. |
| active_dvr | boolean | Enables DVR functionality for the live. Allows users to rewind during the live stream. |