> ## Documentation Index
> Fetch the complete documentation index at: https://docs.vturb.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Update smart autoplay

> Enable the muted-autoplay overlay and pick its template and position.

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](/guides/merge-patch): send only the keys you want to
change and everything else keeps its stored value.

## Pick a template

<CodeGroup>
  ```bash cURL theme={null}
  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" } ] } }'
  ```

  ```json Body theme={null}
  {
    "smart_autoplay": {
      "enabled": true,
      "variants": [
        {
          "template_name": "modern",
          "template_position": "middle-center"
        }
      ]
    }
  }
  ```
</CodeGroup>

## 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.