Reference
Release NoteHelpcenterStatus PageContact Us
  1. Dailymotion API v2
  2. Livestream

Update a livestream

patch
https://api.dailymotion.com/v2/livestreams/

Update scheduling, metadata, recording, geo-restriction, or
embedding settings. Returns 204 No Content on success. Requires
live.manage
scope.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
📘

You are reading API v2 documentation

Still using the Legacy API? Access the Legacy API documentation.



Path Params
string
required
Body Params
string
length between 1 and 255
(?:\S+\s*)+

Title of the livestream. Cannot be blank. Maximum 255 characters.

Required when creating a livestream. Must be at least 1 characters. Must be at most 255 characters. Must match pattern: (?:\S+\s*)+.

length ≤ 3000

Optional description of the livestream. Supports HTML.
Maximum 3000 characters. Leading and trailing whitespace is trimmed. Must be at most 3000 characters. Accepts HTML content.

^[a-zA-Z]{2}$

ISO 639-1 language code (e.g. en, fr). Must match pattern: ^[a-zA-Z]{2}$.

string
^[a-zA-Z]{2}$

ISO 3166-1 alpha-2 country code (e.g. US, FR). Must match pattern: ^[a-zA-Z]{2}$.

string
enum

Who can watch the livestream.

Values: public, private, password, or drm_protected.
Required when creating a livestream.

drm_protected is only available on DRM-enabled channels: the livestream
is private and protected with the channel's default DRM configuration. It
is returned only to callers whose organization has DRM and who can edit
videos; others read such a livestream as private.

Allowed:
boolean

Whether the livestream is made for kids (COPPA). Required on create. Strict type checking (no coercion).

boolean

Whether the livestream is explicit.

Warning This flag cannot be removed once set. Strict type checking (no coercion).

boolean

Whether the livestream is exclusive to Dailymotion. Strict type checking (no coercion).

boolean

Whether the livestream content was altered with AI. Strict type checking (no coercion).

boolean

Whether the livestream discloses a paid partnership. Strict type checking (no coercion).

boolean

Whether comments are enabled on this livestream. Strict type checking (no coercion).

length between 1 and 32

Password for the livestream when visibility is password. Must be at least 1 characters. Must be at most 32 characters. Required when visibility is password. Not allowed unless visibility is password.

ISO 8601 timestamp when the stream started (or is scheduled to start).

ISO 8601 timestamp when the stream ended (or is scheduled to end).

recording
object

Recording configuration and status.

geo_restriction
object

Geo-restriction settings. Optional at creation; when provided, both
mode and countries must be supplied.

embedding
object

Embedding settings for the live player.

protection
object

Protection of this livestream: none or drm.

Only available on DRM-enabled channels. A drm protection makes the
livestream private.

drm_configuration
object

Custom DRM configuration of this livestream.

Only available on DRM-enabled channels. Read it when protection has
drm_configuration_source set to custom; null when the livestream has
none.

Responses
204

Successful Response

Updated 4 months ago

Did this page help you?
Language
Credentials
Bearer
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated 4 months ago

Did this page help you?