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
enum

Content category used for discovery and reporting.

Required when creating a livestream.

^[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, or password.
Required when creating a livestream.

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. Only allowed when 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.

Responses
204

Successful Response

Updated about 1 month 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 about 1 month ago

Did this page help you?