> ## 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 progress bar

> Shape the decoy progress bar — height, color, and whether it borrows the player's palette.

The progress bar here is the decoy bar — the one that advances on its own curve
to keep the viewer engaged, independent of the real seek position.

This is a [merge-patch](/guides/merge-patch): send only the keys you want to
change and everything else keeps its stored value.

## Make it tall and red

<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 '{ "progress_bar": { "enabled": true, "height": 8, "use_base_color": false, "color": "#FF0000" } }'
  ```

  ```json Body theme={null}
  {
    "progress_bar": {
      "enabled": true,
      "height": 8,
      "use_base_color": false,
      "color": "#FF0000"
    }
  }
  ```
</CodeGroup>

## The keys

| Key              | Type    | Writes                                           |
| ---------------- | ------- | ------------------------------------------------ |
| `enabled`        | boolean | Shows or hides the bar                           |
| `height`         | integer | Bar height in pixels                             |
| `use_base_color` | boolean | Reuse the player's base color instead of `color` |
| `color`          | string  | Hex color of the bar, e.g. `#FF0000`             |

`GET` also returns `current_color` — the color the bar is actually rendering
with right now. It's derived, so writes to it are ignored.