Reference
Release NoteHelpcenterStatus PageContact Us

Edit a video

post
https://api.dailymotion.com/video/

Edit an existing video.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
string
required

The unique identifier of the video you want to edit.

Query Params
string

List of fields to return.

To add several fields, separate each value with a comma (i.e. title,description)

Sample of possible values: title description id channel content_provider country created_time duration embed_html embed_url geoblocking is_created_for_kids language mode private private_id publish_date published url

See the exhaustive list of possible values and their description.

Form Data
string
required
Defaults to news

Category of the video.

Possible values: animals auto creation fun kids lifestyle music news people school shortfilms sport tech travel tv videogames webcam

See all video categories.

boolean
required
Defaults to false

True if this video is "created for kids" (intends to target an audience under the age of 16).

string
required
Defaults to My new video title

Title of the video.

boolean

True if this video can be embedded outside of Dailymotion.

boolean

True if this video can be added to playlists

string

Limit the result set to this country (declarative).
Example: us

string

Comprehensive description of this video.
Sample value: This is a sample description for my video.Min: 1
Max: 3000

date-time

End date and time of this live stream.
Sample value: 1404129540

boolean

By default, videos reaching their expiry_date are still available to anyone who knows how to access their private URL. Set this to false to disable this behavior.

boolean

By default, videos are deleted (after a grace period) when their expiry_date is reached. Set this to false to disable this behavior.

Note: Only Pro Advanced & Enterprise customers are allowed to manage video availability and expiration dates.

string

Date and time after which this video will be made private.

Beware: if the video was originally defined as private, setting this value will automatically make it public between its publish_date and expiry_date. This setting only affects the visibility of the video, it will still be available to anyone who knows how to access the video’s private URL even after this date. Omitting this value while setting a past publish_date never expires the video. Set to null (recommended) or a date after Jan 19th 2038 to reset this parameter.

Note : Only Pro Advanced & Enterprise customers are allowed to manage video availability and expiration dates.

Sample value: 1287507036

string

True if this video is explicit.
Warning: It’s not possible to remove this flag once set.

geoblocking
array of strings

List of countries where this video is or isn't accessible. To set geoblocking on your videos, you have to be a Dailymotion Pro.

A list of country codes (ISO 3166-1 alpha-2) starting with the `deny` or `allow` (default) keyword to define if this is a block or an allowlist.

  • E.g.: both `allow, fr, us, it` and `fr, us, it` will allow this video to be accessed in France, US and Italy and deny all other countries.
  • On the other hand, `deny, us, fr` will deny access to this video in the US and France and allow it everywhere else.
  • An empty list or simply `allow` (the default) will revert the behavior to allow from everywhere.
geoblocking
geoloc
array of strings

required Default Value Geolocalization for this video. Result is an array with the longitude and latitude using point notation. Longitude range is from -180.0 (West) to 180.0 (East). Latitude range is from -90.0 (South) to 90.0 (North).

Sample value: -122.40061283112, 37.782112059896
Min: 1 Max: 150

geoloc
hashtags
array of strings

List of hashtags attached to this video.

Sample value: # hello, #world
Min: 1 Max: 150

hashtags
string

Language of this video. This value is declarative and corresponds to the user-declared spoken language of the video. Allowed values are ISO-639-3 alpha-2 and alpha-3 language codes.

Sample value: en
Min: 1 Max: 150

integer

Launches a given number of ad breaks for this live stream.

Sample value: 1

boolean

True if this live stream is automatically recorded.

string

Stream mode. Allowed values: vod or live

boolean

True if this video is private.

date-time

Date and time after which this video will be made publicly available.

Beware: If the video was originally defined as private, setting this value will automatically make it public after the publish_date.

This setting only affects the visibility of the video, it will still be available to anyone who knows how to access the video’s private URL even before this date. Omitting this value while setting a future expiry_date immediately publishes the video. Set to null (recommended) or a date before Jan 1st 1990 to reset this parameter.

Note: Only verified partners are allowed to manage video availability and expiration dates.

Sample value: 1287507036

string

Keep this video private when its publication_date is reached.

boolean

True if this video is published (may still be waiting for encoding, see the status field for more information).

string

Current state of the recording process of this video. * starting: Recording video is going to start. * started: Recording video is in progress. * stopping: Recording video is going to stop. * stopped: Recording video is stoppedSample value: started.

string

The International Standard Recording Code of the soundtrack associated to this video.

Sample value: FR-6V8-21-83311
Min: 1 Max: 150

integer

Soundtrack popularity.

Sample value: 100
Min: 0

date-time

Start date and time of this live stream.

Sample value: 1287507036

boolean

Whether the video stream has been altered by AI.

tags
array of strings

List of tags attached to this video.

Sample value: party john doe
Min: 1 Max: 150

tags
string

URL of this video’s raw thumbnail (full size respecting ratio). Some users have the permission to change this value by providing an URL to a custom thumbnail. If you don’t have the permission, the thumbnail won’t be updated. Note: for live streams, the thumbnail is automatically generated every 5 mn by default; it is not possible anymore to manually refresh the preview. Maximum allowed file size is 10MB.

Sample value: https://s2.dmcdn.net/CTrg1.jpg

string

URL of this video on Dailymotion.

Writing this parameter defines where to download the video source. You may either use this parameter at video creation time or change this parameter later if you want to change this video source afterward.

To change an existing video, the authenticated user may need some additional permissions. You may use the GET /file/upload API resource to upload a video file and create a URL to provide to this method or use an existing URL pointing to your own video file.

Writing to this parameter is subject to rate limiting.

Sample value: https://www.dailymotion.com/video/x26m1j4

Response
200

Updated 5 months ago

Language
Credentials
Bearer
LoadingLoading…
Response
Click Try It! to start a request and see the response here!

Updated 5 months ago