Docs

Reset a video's player controls to the organization defaults

Clears per-video overrides so the video inherits the organization defaults. An empty body resets every override; otherwise pass section, keys (catalog keys), or all. Requires the videos:write scope. The response is the resolved effective config after the reset.

POST
/v1/videos/{id}/controls/reset

Authorization

BearerAuth
AuthorizationBearer <token>

Pass the raw API key as a Bearer token (Authorization: Bearer <key>). Publishable keys start with mvi_pub_ (playback-scoped). Other prefixes denote private/admin keys for general REST routes. GET /v1/embeds/{embedId}/playback accepts publishable keys only.

In: header

Path Parameters

id*string
Formatuuid

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

curl -X POST "https://api.moviie.ai/v1/videos/497f6eca-6276-4993-bfeb-53cbbbba6f08/controls/reset" \  -H "Content-Type: application/json" \  -d '{}'
{
  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
  "t": 0,
  "controls": "string",
  "player_key_color_override": "string",
  "drm_definition_id": "ada110a9-e35d-4206-8d08-901ddc941cde",
  "autoplay": true,
  "preload": true,
  "muted": true,
  "loop": true,
  "show_speed": true,
  "chromecast": true,
  "disable_airplay": true,
  "disable_ios_player": true,
  "remember_position": true,
  "transcript_search_enabled": true,
  "chapters_enabled": true,
  "smart_progress_enabled": true,
  "turbo_start_enabled": true,
  "show_embed_brand": true,
  "playback_rate": 0,
  "effectivePlayerConfig": {
    "values": {
      "property1": true,
      "property2": true
    },
    "items": {
      "property1": {
        "key": "string",
        "section": "appearance",
        "effectiveValue": true,
        "organizationValue": true,
        "videoValue": true,
        "origin": "platform",
        "isOverride": true,
        "canReset": true
      },
      "property2": {
        "key": "string",
        "section": "appearance",
        "effectiveValue": true,
        "organizationValue": true,
        "videoValue": true,
        "origin": "platform",
        "isOverride": true,
        "canReset": true
      }
    }
  }
}
{
  "error": "Resource not found",
  "code": "NOT_FOUND"
}
{
  "error": "Resource not found",
  "code": "NOT_FOUND"
}
{
  "error": "Resource not found",
  "code": "NOT_FOUND"
}