Videos APIGuides

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: send only the keys you want to change and everything else keeps its stored value.

Make it tall and red

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" } }'

The keys

KeyTypeWrites
enabledbooleanShows or hides the bar
heightintegerBar height in pixels
use_base_colorbooleanReuse the player's base color instead of color
colorstringHex 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.

On this page