---
updatedAt: 2026-06-25T11:54:29.000Z
agentTools:
  projectIndex: https://developers.dailymotion.com/llms.txt
---

# Update a player

PATCH player settings (appearance, playback, monetization, PiP,
etc.). Returns **204 No Content** on success. Requires `player.manage`
[scope](https://developers.dailymotion.com/v2/reference/api-scopes)

<Callout icon="📘" theme="info">
  ### You are reading **API v2 documentation**

  Still using the Legacy API? Access the <Anchor target="_blank" href="https://developers.dailymotion.com/v0/docs/welcome">Legacy API documentation</Anchor>.
</Callout>

<br />

<br />

# OpenAPI definition

```json
{
  "openapi": "3.1.0",
  "info": {
    "title": "Dailymotion API v2",
    "description": "The Dailymotion API v2 allows you \nto access and manage your Dailymotion content.\n",
    "version": "2.0.0"
  },
  "servers": [
    {
      "url": "https://api.dailymotion.com/v2",
      "description": "Production"
    }
  ],
  "paths": {
    "/players/{id}": {
      "patch": {
        "tags": [
          "Player"
        ],
        "summary": "Update a player",
        "description": "PATCH player settings (appearance, playback, monetization, PiP,\netc.). Returns **204 No Content** on success. Requires `player.manage`\n[scope](https://developers.dailymotion.com/v2/reference/api-scopes)",
        "operationId": "updatePlayer",
        "security": [
          {
            "Bearer": []
          }
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "title": "Id"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/PlayerUpdate"
              }
            }
          }
        },
        "responses": {
          "204": {
            "description": "Successful Response"
          },
          "401": {
            "description": "**Authentication failed.** No ``Authorization: Bearer`` header, malformed JWT, expired passport, or invalid signature. Identity is not established—unlike **403**, the caller is not treated as an authenticated subject. Typical ``error.code`` values: ``INVALID_AUTHORIZATION``, ``AUTHORIZATION_EXPIRED``.",
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "AUTHORIZATION_EXPIRED",
                    "message": "Authorization expired.",
                    "correlation_id": "550e8400-e29b-41d4-a716-446655440000",
                    "details": {
                      "param": "authorization"
                    },
                    "documentation_url": "https://developers.dailymotion.com/reference/api-errors"
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/DomainErrorEnvelope"
                }
              }
            }
          },
          "403": {
            "description": "**Authorization failed.** The bearer token was accepted, but the caller lacks required OAuth scopes or permissions, or an upstream service denied access to the resource. Typical ``error.code`` values: ``MISSING_PERMISSIONS``, ``UPSTREAM_ACCESS_DENIED``.",
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "MISSING_PERMISSIONS",
                    "message": "Missing required permissions: playlist:write. Required: playlist:read, playlist:write.",
                    "correlation_id": "550e8400-e29b-41d4-a716-446655440000",
                    "details": {
                      "required_permissions": [
                        "playlist:read",
                        "playlist:write"
                      ],
                      "missing_permissions": [
                        "playlist:write"
                      ]
                    },
                    "documentation_url": "https://developers.dailymotion.com/reference/api-errors"
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/DomainErrorEnvelope"
                }
              }
            }
          },
          "404": {
            "description": "**Resource not found.** The path id does not exist, a parent resource in a nested URL is missing, or the object is not visible. Typical ``error.code``: ``RESOURCE_NOT_FOUND``.",
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "RESOURCE_NOT_FOUND",
                    "message": "Video with ID 'x1' not found.",
                    "correlation_id": "550e8400-e29b-41d4-a716-446655440000",
                    "details": {
                      "object_id": "x1",
                      "reason": "object_not_found",
                      "object_type": "Video",
                      "param": "id"
                    },
                    "documentation_url": "https://developers.dailymotion.com/reference/api-errors"
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/DomainErrorEnvelope"
                }
              }
            }
          },
          "422": {
            "description": "**Unprocessable entity (422).** Invalid **path, query, and body parameters** (FastAPI/Pydantic). **Domain validation** (``DomainValidationError`` and subclasses). **Missing context** (e.g. ``MISSING_PARENT_ID``, ``MISSING_REQUIRED_VALUE``). All 422 responses share the same {\"error\": {\"code\", \"message\", \"correlation_id\", \"details\", \"documentation_url\"}} envelope; code and details vary by error origin.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/DomainErrorEnvelope"
                }
              }
            }
          },
          "429": {
            "description": "**Rate limiting (reserved).** This BFF process does not currently return 429. Clients that reach the API through a gateway or CDN should still be prepared for 429 and ``Retry-After`` from those layers.",
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "TOO_MANY_REQUESTS",
                    "message": "Too many requests. Retry after the indicated delay.",
                    "correlation_id": "550e8400-e29b-41d4-a716-446655440000",
                    "details": {
                      "retry_after_seconds": 60
                    },
                    "documentation_url": "https://developers.dailymotion.com/reference/api-errors"
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/DomainErrorEnvelope"
                }
              }
            }
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "DomainErrorEnvelope": {
        "properties": {
          "error": {
            "$ref": "#/components/schemas/DomainErrorPayload"
          }
        },
        "type": "object",
        "required": [
          "error"
        ],
        "title": "DomainErrorEnvelope",
        "description": "Standard error body: ``{ \"error\": { ... } }``.\n\nPer-HTTP-status examples (401 vs 403 vs 404, etc.) are attached on each\nresponse in :func:`bff_api.entrypoints.api.openapi.responses.\nstandard_domain_error_responses`, not on this schema alone."
      },
      "DomainErrorPayload": {
        "properties": {
          "code": {
            "type": "string",
            "title": "Code",
            "description": "Stable machine-readable error code (e.g. RESOURCE_NOT_FOUND, MISSING_PERMISSIONS)."
          },
          "message": {
            "type": "string",
            "title": "Message",
            "description": "Human-readable summary."
          },
          "correlation_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Correlation Id",
            "description": "Request correlation id for support (may be null)."
          },
          "details": {
            "anyOf": [
              {
                "additionalProperties": true,
                "type": "object"
              },
              {
                "type": "null"
              }
            ],
            "title": "Details",
            "description": "Structured context; shape depends on *code*."
          },
          "documentation_url": {
            "type": "string",
            "title": "Documentation Url",
            "description": "Link to the public API error reference."
          }
        },
        "type": "object",
        "required": [
          "code",
          "message",
          "documentation_url"
        ],
        "title": "DomainErrorPayload",
        "description": "Fields inside the ``error`` object for non-2xx domain errors."
      },
      "PlayerAdPressureMode": {
        "type": "string",
        "enum": [
          "monetization",
          "balanced",
          "standard"
        ],
        "title": "PlayerAdPressureMode",
        "description": "Advertising pressure modes."
      },
      "PlayerAdvertisingEmbeddedInput": {
        "properties": {
          "enable_ads": {
            "type": "boolean",
            "title": "Enable Ads",
            "description": "Whether ads are enabled.",
            "default": true,
            "example": true
          },
          "enable_eid_collection": {
            "type": "boolean",
            "title": "Enable Eid Collection",
            "description": "Whether EID collection is enabled.",
            "default": false,
            "example": true
          },
          "enable_preload": {
            "type": "boolean",
            "title": "Enable Preload",
            "description": "Whether ad preloading is enabled.",
            "default": true,
            "example": true
          },
          "enable_wait_for_custom_config": {
            "type": "boolean",
            "title": "Enable Wait For Custom Config",
            "description": "Whether ad request waits for custom config.",
            "default": false,
            "example": false
          },
          "pressure_mode": {
            "$ref": "#/components/schemas/PlayerAdPressureMode",
            "description": "Ad pressure optimization mode.",
            "default": "monetization",
            "example": "monetization"
          },
          "wait_for_custom_config_delay": {
            "type": "integer",
            "maximum": 10,
            "minimum": 1,
            "title": "Wait For Custom Config Delay",
            "description": "Delay in seconds before custom config fallback ad request. Must be greater than or equal to `1`. Must be less than or equal to `10`.",
            "default": 6,
            "example": 6
          }
        },
        "additionalProperties": false,
        "type": "object",
        "title": "Player Advertising Embedded Input",
        "example": {
          "enable_ads": true,
          "enable_eid_collection": true,
          "enable_preload": true,
          "enable_wait_for_custom_config": false,
          "pressure_mode": "monetization",
          "wait_for_custom_config_delay": 6
        }
      },
      "PlayerAspectRatio": {
        "type": "string",
        "enum": [
          "inherit",
          "16:9",
          "4:3",
          "1:1",
          "3:4",
          "9:16"
        ],
        "title": "PlayerAspectRatio",
        "description": "Player aspect ratio values."
      },
      "PlayerAutostart": {
        "type": "string",
        "enum": [
          "off",
          "on",
          "first_time_viewable"
        ],
        "title": "PlayerAutostart",
        "description": "Player autostart values."
      },
      "PlayerContentEmbeddedInput": {
        "properties": {
          "enable_profile": {
            "type": "boolean",
            "title": "Enable Profile",
            "description": "Whether to display profile picture of the video owner.",
            "default": true,
            "example": true
          },
          "enable_profile_link": {
            "type": "boolean",
            "title": "Enable Profile Link",
            "description": "Whether to activate the link on the profile picture of the video owner.",
            "default": true,
            "example": true
          },
          "enable_title": {
            "type": "boolean",
            "title": "Enable Title",
            "description": "Whether content title is shown.",
            "default": true,
            "example": true
          },
          "enable_title_link": {
            "type": "boolean",
            "title": "Enable Title Link",
            "description": "Whether content title link is enabled.",
            "default": true,
            "example": true
          }
        },
        "additionalProperties": false,
        "type": "object",
        "title": "Player Content Embedded Input",
        "example": {
          "enable_profile": true,
          "enable_profile_link": true,
          "enable_title": true,
          "enable_title_link": true
        }
      },
      "PlayerContextualContentSource": {
        "type": "string",
        "enum": [
          "profile",
          "organization",
          "dailymotion"
        ],
        "title": "PlayerContextualContentSource",
        "description": "Contextual content source values."
      },
      "PlayerContextualEmbeddedInput": {
        "properties": {
          "enable_contextual_content": {
            "type": "boolean",
            "title": "Enable Contextual Content",
            "description": "Whether contextual content is enabled.",
            "default": false,
            "example": false
          },
          "enable_fallback": {
            "type": "boolean",
            "title": "Enable Fallback",
            "description": "Whether contextual fallback is enabled.",
            "default": true,
            "example": true
          },
          "enable_freshness": {
            "type": "boolean",
            "title": "Enable Freshness",
            "description": "Whether contextual freshness filtering is enabled.",
            "default": false,
            "example": false
          },
          "freshness_days": {
            "type": "integer",
            "title": "Freshness Days",
            "description": "Freshness window in days.",
            "default": 1800,
            "example": 1800
          },
          "source": {
            "$ref": "#/components/schemas/PlayerContextualContentSource",
            "description": "Contextual content source.",
            "default": "profile",
            "example": "profile"
          }
        },
        "additionalProperties": false,
        "type": "object",
        "title": "Player Contextual Embedded Input",
        "example": {
          "enable_contextual_content": false,
          "enable_fallback": true,
          "enable_freshness": false,
          "freshness_days": 1800,
          "source": "profile"
        }
      },
      "PlayerInterfaceEmbeddedInput": {
        "properties": {
          "aspect_ratio": {
            "$ref": "#/components/schemas/PlayerAspectRatio",
            "description": "Player aspect ratio.",
            "default": "16:9",
            "example": "16:9"
          },
          "color": {
            "anyOf": [
              {
                "type": "string",
                "pattern": "^$|^([a-fA-F0-9]{6}|[a-fA-F0-9]{3})$"
              },
              {
                "type": "null"
              }
            ],
            "title": "Color",
            "description": "Player color in hex format without #. Must match pattern: `^$|^([a-fA-F0-9]{6}|[a-fA-F0-9]{3})$`.",
            "example": "123456"
          },
          "enable_ads_controls": {
            "type": "boolean",
            "title": "Enable Ads Controls",
            "description": "Whether controls are visible during ads.",
            "default": true,
            "example": true
          },
          "enable_attention_peaks": {
            "type": "boolean",
            "title": "Enable Attention Peaks",
            "description": "Whether attention peaks are visible.",
            "default": true,
            "example": true
          },
          "enable_controls": {
            "type": "boolean",
            "title": "Enable Controls",
            "description": "Whether playback controls are visible.",
            "default": true,
            "example": true
          },
          "enable_dm_logo": {
            "type": "boolean",
            "title": "Enable Dm Logo",
            "description": "Whether Dailymotion logo is visible.",
            "default": true,
            "example": true
          },
          "enable_dynamic_thumbnail": {
            "type": "boolean",
            "title": "Enable Dynamic Thumbnail",
            "description": "Whether dynamic thumbnail is enabled.",
            "default": false,
            "example": false
          },
          "enable_keyboard_shortcuts": {
            "type": "boolean",
            "title": "Enable Keyboard Shortcuts",
            "description": "Whether keyboard shortcuts are enabled.",
            "default": true,
            "example": true
          },
          "enable_live_offair_screen": {
            "type": "boolean",
            "title": "Enable Live Offair Screen",
            "description": "Whether live off-air screen is visible.",
            "default": true,
            "example": true
          },
          "enable_paid_partnership_label": {
            "type": "boolean",
            "title": "Enable Paid Partnership Label",
            "description": "Whether paid partnership label is enabled.",
            "default": false,
            "example": false
          },
          "enable_sharing": {
            "type": "boolean",
            "title": "Enable Sharing",
            "description": "Whether sharing is enabled.",
            "default": true,
            "example": true
          },
          "enable_sharing_url_location": {
            "type": "boolean",
            "title": "Enable Sharing Url Location",
            "description": "Whether sharing URL includes embedding page location.",
            "default": false,
            "example": false
          },
          "enable_spinner": {
            "type": "boolean",
            "title": "Enable Spinner",
            "description": "Whether spinner is shown while buffering.",
            "default": true,
            "example": true
          },
          "enable_startscreen_dm_link": {
            "type": "boolean",
            "title": "Enable Startscreen Dm Link",
            "description": "Whether Dailymotion startscreen link is shown.",
            "default": true,
            "example": true
          },
          "enable_subtitles": {
            "type": "boolean",
            "title": "Enable Subtitles",
            "description": "Whether subtitles toggle is enabled.",
            "default": true,
            "example": true
          },
          "enable_titles_in_video_cards": {
            "type": "boolean",
            "title": "Enable Titles In Video Cards",
            "description": "Whether titles are shown in endscreen cards.",
            "default": true,
            "example": true
          },
          "enable_watch_now_card": {
            "type": "boolean",
            "title": "Enable Watch Now Card",
            "description": "Whether watch now card is shown.",
            "default": true,
            "example": true
          }
        },
        "additionalProperties": false,
        "type": "object",
        "title": "Player Interface Embedded Input",
        "example": {
          "aspect_ratio": "16:9",
          "color": "123456",
          "enable_ads_controls": true,
          "enable_attention_peaks": true,
          "enable_controls": true,
          "enable_dm_logo": true,
          "enable_dynamic_thumbnail": false,
          "enable_keyboard_shortcuts": true,
          "enable_live_offair_screen": true,
          "enable_paid_partnership_label": false,
          "enable_sharing": true,
          "enable_sharing_url_location": false,
          "enable_spinner": true,
          "enable_startscreen_dm_link": true,
          "enable_subtitles": true,
          "enable_titles_in_video_cards": true,
          "enable_watch_now_card": true
        }
      },
      "PlayerPipEmbeddedInput": {
        "properties": {
          "enable_google_policy_ui": {
            "type": "boolean",
            "title": "Enable Google Policy Ui",
            "description": "Whether Google Policy UI is enabled.",
            "default": false,
            "example": false
          },
          "enable_large_size": {
            "type": "boolean",
            "title": "Enable Large Size",
            "description": "Whether large PiP size is enabled.",
            "default": false,
            "example": false
          },
          "enable_selected_placement": {
            "type": "boolean",
            "title": "Enable Selected Placement",
            "description": "Whether selected placement is enabled.",
            "default": true,
            "example": false
          },
          "mode": {
            "$ref": "#/components/schemas/PlayerPipEnabled",
            "description": "PiP mode.",
            "default": "off",
            "example": "off"
          },
          "selected_placement": {
            "$ref": "#/components/schemas/PlayerPipPlacement",
            "description": "Selected placement for PiP.",
            "default": "bottom_right",
            "example": "bottom_right"
          }
        },
        "additionalProperties": false,
        "type": "object",
        "title": "Player Pip Embedded Input",
        "example": {
          "enable_google_policy_ui": false,
          "enable_large_size": false,
          "enable_selected_placement": false,
          "mode": "off",
          "selected_placement": "bottom_right"
        }
      },
      "PlayerPipEnabled": {
        "type": "string",
        "enum": [
          "instant",
          "on",
          "off"
        ],
        "title": "PlayerPipEnabled",
        "description": "Picture-in-picture enablement modes."
      },
      "PlayerPipPlacement": {
        "type": "string",
        "enum": [
          "bottom_right",
          "bottom_left",
          "top_right",
          "top_left"
        ],
        "title": "PlayerPipPlacement",
        "description": "Picture-in-picture placement values."
      },
      "PlayerPlaybackEmbeddedInput": {
        "properties": {
          "autonext_duration": {
            "type": "integer",
            "title": "Autonext Duration",
            "description": "Autonext duration in seconds.",
            "default": 6,
            "example": 6
          },
          "autoskip_duration": {
            "type": "integer",
            "minimum": 10,
            "title": "Autoskip Duration",
            "description": "Autoskip duration in seconds. Must be greater than or equal to `10`.",
            "default": 10,
            "example": 20
          },
          "autostart_mode": {
            "$ref": "#/components/schemas/PlayerAutostart",
            "description": "Autostart mode.",
            "default": "first_time_viewable",
            "example": "off"
          },
          "enable_autonext": {
            "type": "boolean",
            "title": "Enable Autonext",
            "description": "Whether autonext is enabled.",
            "default": true,
            "example": true
          },
          "enable_autoskip": {
            "type": "boolean",
            "title": "Enable Autoskip",
            "description": "Whether autoskip is enabled.",
            "default": false,
            "example": false
          },
          "enable_content_preload": {
            "type": "boolean",
            "title": "Enable Content Preload",
            "description": "Whether content preload is enabled.",
            "default": false,
            "example": false
          },
          "enable_eco_mode": {
            "type": "boolean",
            "title": "Enable Eco Mode",
            "description": "Whether eco mode is enabled.",
            "default": false,
            "example": false
          },
          "enable_receive_url_location": {
            "type": "boolean",
            "title": "Enable Receive Url Location",
            "description": "Whether full embedding page URL can be received.",
            "default": true,
            "example": true
          },
          "enable_hold_to_fastforward": {
            "type": "boolean",
            "title": "Enable Hold To Fastforward",
            "description": "Whether hold-to-fastforward is enabled.",
            "default": true,
            "example": true
          },
          "enable_mute": {
            "type": "boolean",
            "title": "Enable Mute",
            "description": "Whether player starts muted.",
            "default": false,
            "example": false
          }
        },
        "additionalProperties": false,
        "type": "object",
        "title": "Player Playback Embedded Input",
        "example": {
          "autonext_duration": 6,
          "autoskip_duration": 20,
          "autostart_mode": "off",
          "enable_autonext": true,
          "enable_autoskip": false,
          "enable_content_preload": false,
          "enable_eco_mode": false,
          "enable_receive_url_location": true,
          "enable_hold_to_fastforward": true,
          "enable_mute": false
        }
      },
      "PlayerRecommendationMode": {
        "type": "string",
        "enum": [
          "views",
          "engagement",
          "monetization"
        ],
        "title": "PlayerRecommendationMode",
        "description": "Recommendation optimization modes."
      },
      "PlayerRecommendationsEmbeddedInput": {
        "properties": {
          "enable_automatic": {
            "type": "boolean",
            "title": "Enable Automatic",
            "description": "Whether automatic recommendations are enabled.",
            "default": true,
            "example": true
          },
          "enable_custom": {
            "type": "boolean",
            "title": "Enable Custom",
            "description": "Whether custom recommendations are enabled.",
            "default": false,
            "example": false
          },
          "optimization_mode": {
            "$ref": "#/components/schemas/PlayerRecommendationMode",
            "description": "Recommendations optimization mode.",
            "default": "monetization",
            "example": "views"
          }
        },
        "additionalProperties": false,
        "type": "object",
        "title": "Player Recommendations Embedded Input",
        "example": {
          "enable_automatic": true,
          "enable_custom": false,
          "optimization_mode": "views"
        }
      },
      "PlayerTypeEmbeddedInput": {
        "properties": {
          "mode": {
            "$ref": "#/components/schemas/PlayerTypeMode",
            "description": "Player type mode.",
            "default": "video",
            "example": "video"
          }
        },
        "additionalProperties": false,
        "type": "object",
        "title": "Player Type Embedded Input",
        "example": {
          "mode": "video"
        }
      },
      "PlayerTypeMode": {
        "type": "string",
        "enum": [
          "video",
          "audio"
        ],
        "title": "PlayerTypeMode",
        "description": "Player type mode values."
      },
      "PlayerUpdate": {
        "properties": {
          "name": {
            "type": "string",
            "maxLength": 255,
            "minLength": 1,
            "title": "Name",
            "description": "Display name of the player. Between 1 and 255 characters. Must be at least 1 characters. Must be at most 255 characters.",
            "example": "My Branded Player"
          },
          "advertising": {
            "$ref": "#/components/schemas/PlayerAdvertisingEmbeddedInput",
            "description": "Advertising and monetization settings.",
            "example": "{\"enable_ads\": true}"
          },
          "content": {
            "$ref": "#/components/schemas/PlayerContentEmbeddedInput",
            "description": "Content title/profile visibility settings.",
            "example": "{\"enable_title\": true, \"enable_profile\": true}"
          },
          "contextual": {
            "$ref": "#/components/schemas/PlayerContextualEmbeddedInput",
            "description": "Contextual recommendation settings.",
            "example": "{\"enable_contextual_content\": false}"
          },
          "interface": {
            "$ref": "#/components/schemas/PlayerInterfaceEmbeddedInput",
            "description": "Player interface settings.",
            "example": "{\"enable_controls\": true}"
          },
          "pip": {
            "$ref": "#/components/schemas/PlayerPipEmbeddedInput",
            "description": "Picture-in-Picture (PiP) settings.",
            "example": "{\"enabled\": true}"
          },
          "watermark": {
            "$ref": "#/components/schemas/PlayerWatermarkEmbeddedInput",
            "description": "Watermark overlay settings.",
            "example": "{\"enabled\": false}"
          },
          "playback": {
            "$ref": "#/components/schemas/PlayerPlaybackEmbeddedInput",
            "description": "Playback behaviour settings.",
            "example": "{\"autostart_mode\": \"off\"}"
          },
          "recommendations": {
            "$ref": "#/components/schemas/PlayerRecommendationsEmbeddedInput",
            "description": "Recommendations settings.",
            "example": "{\"optimization_mode\": \"views\"}"
          },
          "type": {
            "$ref": "#/components/schemas/PlayerTypeEmbeddedInput",
            "description": "Player type configuration.",
            "example": "{\"enable_inline\": false, \"mode\": \"video\"}"
          }
        },
        "additionalProperties": false,
        "type": "object",
        "title": "Player Update",
        "example": {
          "name": "My Branded Player",
          "advertising": {
            "enable_ads": true,
            "enable_eid_collection": true,
            "enable_preload": true,
            "enable_wait_for_custom_config": false,
            "pressure_mode": "monetization",
            "wait_for_custom_config_delay": 6
          },
          "content": {
            "enable_profile": true,
            "enable_profile_link": true,
            "enable_title": true,
            "enable_title_link": true
          },
          "contextual": {
            "enable_contextual_content": false,
            "enable_fallback": true,
            "enable_freshness": false,
            "freshness_days": 1800,
            "source": "profile"
          },
          "interface": {
            "aspect_ratio": "16:9",
            "color": "123456",
            "enable_ads_controls": true,
            "enable_attention_peaks": true,
            "enable_controls": true,
            "enable_dm_logo": true,
            "enable_dynamic_thumbnail": false,
            "enable_keyboard_shortcuts": true,
            "enable_live_offair_screen": true,
            "enable_paid_partnership_label": false,
            "enable_sharing": true,
            "enable_sharing_url_location": false,
            "enable_spinner": true,
            "enable_startscreen_dm_link": true,
            "enable_subtitles": true,
            "enable_titles_in_video_cards": true,
            "enable_watch_now_card": true
          },
          "pip": {
            "enable_google_policy_ui": false,
            "enable_large_size": false,
            "enable_selected_placement": false,
            "mode": "off",
            "selected_placement": "bottom_right"
          },
          "watermark": {
            "image_type": "from_profile",
            "link_type": "none",
            "link_url": "https://www.dailymotion.com/mychannel"
          },
          "playback": {
            "autonext_duration": 6,
            "autoskip_duration": 20,
            "autostart_mode": "off",
            "enable_autonext": true,
            "enable_autoskip": false,
            "enable_content_preload": false,
            "enable_eco_mode": false,
            "enable_receive_url_location": true,
            "enable_hold_to_fastforward": true,
            "enable_mute": false
          },
          "recommendations": {
            "enable_automatic": true,
            "enable_custom": false,
            "optimization_mode": "views"
          },
          "type": {
            "mode": "video"
          }
        }
      },
      "PlayerWatermarkEmbeddedInput": {
        "properties": {
          "image_type": {
            "$ref": "#/components/schemas/PlayerWatermarkImageType",
            "description": "Watermark image type.",
            "default": "none",
            "example": "from_profile"
          },
          "link_type": {
            "$ref": "#/components/schemas/PlayerWatermarkLinkType",
            "description": "Watermark link type.",
            "default": "none",
            "example": "none"
          },
          "link_url": {
            "anyOf": [
              {
                "type": "string",
                "x-allowed-schemes": [
                  "http",
                  "https"
                ]
              },
              {
                "type": "null"
              }
            ],
            "title": "Link Url",
            "description": "Watermark link URL. URL scheme must be one of: http, https.",
            "example": "https://www.dailymotion.com/mychannel"
          }
        },
        "additionalProperties": false,
        "type": "object",
        "title": "Player Watermark Embedded Input",
        "example": {
          "image_type": "from_profile",
          "link_type": "none",
          "link_url": "https://www.dailymotion.com/mychannel"
        }
      },
      "PlayerWatermarkImageType": {
        "type": "string",
        "enum": [
          "none",
          "from_profile",
          "custom"
        ],
        "title": "PlayerWatermarkImageType",
        "description": "Watermark image source values."
      },
      "PlayerWatermarkLinkType": {
        "type": "string",
        "enum": [
          "none",
          "from_profile",
          "custom"
        ],
        "title": "PlayerWatermarkLinkType",
        "description": "Watermark link target values."
      }
    },
    "securitySchemes": {
      "Bearer": {
        "type": "http",
        "description": "JWT token for authentication. Can be retrieved using https://oauth2.dailymotion.com/v1/token",
        "scheme": "bearer"
      }
    }
  },
  "tags": [
    {
      "name": "Player",
      "description": "Embeddable video player configuration.\n\nCovers appearance, playback, ads, and recommendations."
    }
  ]
}
```