VTurb API

Smart autoplay starts the video muted and lays an unmute overlay on top. The write is selection-only: you pick a template and where it sits on the player’s 3×3 grid, and the API builds the overlay from that preset. This is a merge-patch: send only the keys you want to change and everything else keeps its stored value.

Pick a template

curl -X PATCH https://api.vturb.com/v1/videos/{id} \
  -H "Authorization: Bearer vt_..." \
  -H "Content-Type: application/json" \
  -d '{ "smart_autoplay": { "enabled": true, "variants": [ { "template_name": "modern", "template_position": "middle-center" } ] } }'

{
  "smart_autoplay": {
    "enabled": true,
    "variants": [
      {
        "template_name": "modern",
        "template_position": "middle-center"
      }
    ]
  }
}

The keys

Key	Type	Writes
`enabled`	boolean	Turns smart autoplay on or off
`variants[].template_name`	string	One of `default`, `discrete`, `modern`, `sightcare`, `fullscreen`
`variants[].template_position`	string	Grid slot: `top`/`middle`/`bottom` × `left`/`center`/`right`, e.g. `middle-center`

An unknown template or position is a 422 unprocessable_content. GET may also return mode and active_number — those describe the A/B experiment the platform runs across variants and are read-only. A variant that was hand-sculpted on the dashboard (not built from a preset) renders its full object instead of the two selection keys.