Table of content

Scopes


Overview

Scopes are used to define which permissions or access rights can be granted to the user authenticating. They are specified when requesting an access token and can be combined. Each scope allows the authenticated user to access and/or manipulate specific protected resources only.


Available scopes

The scopes available on the Dailymotion API are as follows:

SCOPEDESCRIPTION
emailProvides access to the email of the main user of the Dailymotion channel
manage_likes Allows to add/remove videos from the list liked video (“likes”) on behalf of the user
manage_playersAllows create/modify/delete Players on behalf of user
manage_playlistsAllows to create/edit/delete playlists on behalf of the user
manage_podcastsAllows to create/edit/delete podcasts on behalf of the user
manage_subscriptionsAllows to subscribe to channels on behalf of the user
manage_subtitlesAllows to create/edit/delete subtitles on behalf of the user
manage_videosAllows to create/edit/delete uploaded videos on behalf of the user
userinfoProvides read/write access to some personal user information like address and birthday

Request access token with scopes

You can include specific scopes using the scope parameter when requesting an access token during authentication.

If multiple scopes are needed, you can separate them with a blank space.

In the following request example, we are requesting an access token with 2 scopes:

  • userinfo which gives read and write access to the user personal information
  • manage_videos which allows to create/edit/delete videos on the user’s Dailymotion channel
POST /oauth/token HTTP/1.1
Host: api.dailymotion.com
Content-Type: application/x-www-form-urlencoded

grant_type=client_credentials
    &client_id=<API_KEY>
    &client_secret=<API_SECRET>
    &scope=userinfo+manage_videos
Note:

OAuth 2.0 doesn’t allow to upgrade the scope of an existing session.
To add new scopes to an existing session, you first need to call the /logout endpoint, and then start a new session with your new list of scopes.