Videos
Update a video
PATCH
/
v1
/
videos
/
{id}
Update a video
curl --request PATCH \
--url https://api.vturb.com/v1/videos/{id} \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"controls": {
"backward": true,
"big_play": false,
"forward": true,
"fullscreen": true,
"play_pause": true,
"seekbar": true,
"time": true,
"volume": true,
"fake_bar": false,
"speed": true
},
"alternative_video": {
"enabled": true,
"id": "507f191e810c19729de860ea"
},
"immersive_mode": {
"desktop": true,
"disable_scrolling": false,
"expand_on_play": true,
"minimize_on_pause": false,
"mobile": true,
"enabled": true
},
"traffic_filter": {
"fallback_video_id": "507f191e810c19729de860ea",
"token": "gate_7f3c1a",
"languages": [
"pt",
"en"
],
"countries": [
"BR",
"US"
],
"devices": [
"desktop",
"mobile"
],
"query_params": [
"utm_source"
],
"block_proxy": true,
"enabled": true
},
"playback": {
"disable_pause": false,
"smart_pause": true,
"scroll_to_action_in": 30,
"action_after_finish": {
"type": "loop",
"start": 5
},
"enabled": true
},
"progress_bar": {
"height": 12,
"use_base_color": false,
"color": "#0000FF",
"enabled": true
},
"subtitle": {
"control": true,
"style": {
"font_size": "16px",
"color": "#FFFFFF",
"background_color": "#000000",
"text_align": "center",
"show_by_default": true
},
"enabled": true,
"track": {
"file_id": "0190a0b0-2222-7222-8222-222222222222"
}
},
"resume": {
"disable_pause": false,
"styles": {
"background_color": "#1890FF",
"foreground_color": "#FFFFFF"
},
"texts": {
"play": "Keep watching",
"replay": "Replay",
"title": "You already started"
},
"enabled": true
},
"call_actions": {
"enabled": true,
"items": [
{
"base": {
"type": "outside_video",
"active": true
},
"window": {
"start": 5,
"end": 30
},
"action": {
"content": "Buy now",
"url": "https://example.com/checkout",
"open_in_new_tab": true
},
"design": {
"typography": {
"family": "Inter",
"letter_spacing": 0,
"line_height": 1.2,
"size": 16,
"weight": 600
},
"styles": {
"background_color": "#1890FF",
"background_hover_color": "#096DD9",
"text_color": "#FFFFFF",
"text_hover_color": "#F0F0F0",
"border_radius": 8,
"shadow_enabled": true,
"shadow": {
"blur": 12,
"color": "#00000040",
"horizontal": 0,
"vertical": 4,
"spread": 2
},
"padding": {
"binding": true,
"values": [
12,
24,
12,
24
]
}
}
}
}
]
},
"smart_autoplay": {
"enabled": true,
"variants": [
{
"template_name": "discrete",
"template_position": "top-left"
}
]
},
"pixels": {
"items": [
{
"base": {
"name": "Fresh",
"type": "custom"
},
"tag": {
"html": "<div>tag</div>"
},
"dispatch": {
"active": true,
"threshold": 50,
"mode": "percent"
}
}
],
"enabled": true
},
"turbo": {
"enabled": true,
"speed": 1.5
},
"headline": {
"variants": [
{
"id": "652f2b1e8f1b2c3d4e5f0201",
"base": {
"name": "Renamed"
}
},
{
"base": {
"number": 3
},
"content": {
"kind": "html",
"html": "<h1>New</h1>"
}
},
{
"id": "652f2b1e8f1b2c3d4e5f0202",
"_destroy": true
}
]
},
"name": "Renamed",
"description": "New copy",
"folder_id": "652f2b1e8f1b2c3d4e5f00aa",
"mini_hooks": {
"elements": [
{
"id": "652f2b1e8f1b2c3d4e5f0016",
"content": {
"src_file_id": "0190a0b0-3333-7333-8333-333333333333"
}
}
]
},
"thumbsniper": {
"images": {
"start_file_id": "0190a0b0-1111-7111-8111-111111111111",
"pause_file_id": "0190a0b0-1111-7111-8111-111111111111",
"finish_file_id": "0190a0b0-1111-7111-8111-111111111111"
},
"cards": [
{
"base": {
"image_file_id": "0190a0b0-1111-7111-8111-111111111111"
}
}
]
}
}
'import requests
url = "https://api.vturb.com/v1/videos/{id}"
payload = {
"controls": {
"backward": True,
"big_play": False,
"forward": True,
"fullscreen": True,
"play_pause": True,
"seekbar": True,
"time": True,
"volume": True,
"fake_bar": False,
"speed": True
},
"alternative_video": {
"enabled": True,
"id": "507f191e810c19729de860ea"
},
"immersive_mode": {
"desktop": True,
"disable_scrolling": False,
"expand_on_play": True,
"minimize_on_pause": False,
"mobile": True,
"enabled": True
},
"traffic_filter": {
"fallback_video_id": "507f191e810c19729de860ea",
"token": "gate_7f3c1a",
"languages": ["pt", "en"],
"countries": ["BR", "US"],
"devices": ["desktop", "mobile"],
"query_params": ["utm_source"],
"block_proxy": True,
"enabled": True
},
"playback": {
"disable_pause": False,
"smart_pause": True,
"scroll_to_action_in": 30,
"action_after_finish": {
"type": "loop",
"start": 5
},
"enabled": True
},
"progress_bar": {
"height": 12,
"use_base_color": False,
"color": "#0000FF",
"enabled": True
},
"subtitle": {
"control": True,
"style": {
"font_size": "16px",
"color": "#FFFFFF",
"background_color": "#000000",
"text_align": "center",
"show_by_default": True
},
"enabled": True,
"track": { "file_id": "0190a0b0-2222-7222-8222-222222222222" }
},
"resume": {
"disable_pause": False,
"styles": {
"background_color": "#1890FF",
"foreground_color": "#FFFFFF"
},
"texts": {
"play": "Keep watching",
"replay": "Replay",
"title": "You already started"
},
"enabled": True
},
"call_actions": {
"enabled": True,
"items": [
{
"base": {
"type": "outside_video",
"active": True
},
"window": {
"start": 5,
"end": 30
},
"action": {
"content": "Buy now",
"url": "https://example.com/checkout",
"open_in_new_tab": True
},
"design": {
"typography": {
"family": "Inter",
"letter_spacing": 0,
"line_height": 1.2,
"size": 16,
"weight": 600
},
"styles": {
"background_color": "#1890FF",
"background_hover_color": "#096DD9",
"text_color": "#FFFFFF",
"text_hover_color": "#F0F0F0",
"border_radius": 8,
"shadow_enabled": True,
"shadow": {
"blur": 12,
"color": "#00000040",
"horizontal": 0,
"vertical": 4,
"spread": 2
},
"padding": {
"binding": True,
"values": [12, 24, 12, 24]
}
}
}
}
]
},
"smart_autoplay": {
"enabled": True,
"variants": [
{
"template_name": "discrete",
"template_position": "top-left"
}
]
},
"pixels": {
"items": [
{
"base": {
"name": "Fresh",
"type": "custom"
},
"tag": { "html": "<div>tag</div>" },
"dispatch": {
"active": True,
"threshold": 50,
"mode": "percent"
}
}
],
"enabled": True
},
"turbo": {
"enabled": True,
"speed": 1.5
},
"headline": { "variants": [
{
"id": "652f2b1e8f1b2c3d4e5f0201",
"base": { "name": "Renamed" }
},
{
"base": { "number": 3 },
"content": {
"kind": "html",
"html": "<h1>New</h1>"
}
},
{
"id": "652f2b1e8f1b2c3d4e5f0202",
"_destroy": True
}
] },
"name": "Renamed",
"description": "New copy",
"folder_id": "652f2b1e8f1b2c3d4e5f00aa",
"mini_hooks": { "elements": [
{
"id": "652f2b1e8f1b2c3d4e5f0016",
"content": { "src_file_id": "0190a0b0-3333-7333-8333-333333333333" }
}
] },
"thumbsniper": {
"images": {
"start_file_id": "0190a0b0-1111-7111-8111-111111111111",
"pause_file_id": "0190a0b0-1111-7111-8111-111111111111",
"finish_file_id": "0190a0b0-1111-7111-8111-111111111111"
},
"cards": [{ "base": { "image_file_id": "0190a0b0-1111-7111-8111-111111111111" } }]
}
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.patch(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PATCH',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
controls: {
backward: true,
big_play: false,
forward: true,
fullscreen: true,
play_pause: true,
seekbar: true,
time: true,
volume: true,
fake_bar: false,
speed: true
},
alternative_video: {enabled: true, id: '507f191e810c19729de860ea'},
immersive_mode: {
desktop: true,
disable_scrolling: false,
expand_on_play: true,
minimize_on_pause: false,
mobile: true,
enabled: true
},
traffic_filter: {
fallback_video_id: '507f191e810c19729de860ea',
token: 'gate_7f3c1a',
languages: ['pt', 'en'],
countries: ['BR', 'US'],
devices: ['desktop', 'mobile'],
query_params: ['utm_source'],
block_proxy: true,
enabled: true
},
playback: {
disable_pause: false,
smart_pause: true,
scroll_to_action_in: 30,
action_after_finish: {type: 'loop', start: 5},
enabled: true
},
progress_bar: {height: 12, use_base_color: false, color: '#0000FF', enabled: true},
subtitle: {
control: true,
style: {
font_size: '16px',
color: '#FFFFFF',
background_color: '#000000',
text_align: 'center',
show_by_default: true
},
enabled: true,
track: {file_id: '0190a0b0-2222-7222-8222-222222222222'}
},
resume: {
disable_pause: false,
styles: {background_color: '#1890FF', foreground_color: '#FFFFFF'},
texts: {play: 'Keep watching', replay: 'Replay', title: 'You already started'},
enabled: true
},
call_actions: {
enabled: true,
items: [
{
base: {type: 'outside_video', active: true},
window: {start: 5, end: 30},
action: {content: 'Buy now', url: 'https://example.com/checkout', open_in_new_tab: true},
design: {
typography: {family: 'Inter', letter_spacing: 0, line_height: 1.2, size: 16, weight: 600},
styles: {
background_color: '#1890FF',
background_hover_color: '#096DD9',
text_color: '#FFFFFF',
text_hover_color: '#F0F0F0',
border_radius: 8,
shadow_enabled: true,
shadow: {blur: 12, color: '#00000040', horizontal: 0, vertical: 4, spread: 2},
padding: {binding: true, values: [12, 24, 12, 24]}
}
}
}
]
},
smart_autoplay: {
enabled: true,
variants: [{template_name: 'discrete', template_position: 'top-left'}]
},
pixels: {
items: [
{
base: {name: 'Fresh', type: 'custom'},
tag: {html: '<div>tag</div>'},
dispatch: {active: true, threshold: 50, mode: 'percent'}
}
],
enabled: true
},
turbo: {enabled: true, speed: 1.5},
headline: {
variants: [
{id: '652f2b1e8f1b2c3d4e5f0201', base: {name: 'Renamed'}},
{base: {number: 3}, content: {kind: 'html', html: '<h1>New</h1>'}},
{id: '652f2b1e8f1b2c3d4e5f0202', _destroy: true}
]
},
name: 'Renamed',
description: 'New copy',
folder_id: '652f2b1e8f1b2c3d4e5f00aa',
mini_hooks: {
elements: [
{
id: '652f2b1e8f1b2c3d4e5f0016',
content: {src_file_id: '0190a0b0-3333-7333-8333-333333333333'}
}
]
},
thumbsniper: {
images: {
start_file_id: '0190a0b0-1111-7111-8111-111111111111',
pause_file_id: '0190a0b0-1111-7111-8111-111111111111',
finish_file_id: '0190a0b0-1111-7111-8111-111111111111'
},
cards: [{base: {image_file_id: '0190a0b0-1111-7111-8111-111111111111'}}]
}
})
};
fetch('https://api.vturb.com/v1/videos/{id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.vturb.com/v1/videos/{id}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "PATCH",
CURLOPT_POSTFIELDS => json_encode([
'controls' => [
'backward' => true,
'big_play' => false,
'forward' => true,
'fullscreen' => true,
'play_pause' => true,
'seekbar' => true,
'time' => true,
'volume' => true,
'fake_bar' => false,
'speed' => true
],
'alternative_video' => [
'enabled' => true,
'id' => '507f191e810c19729de860ea'
],
'immersive_mode' => [
'desktop' => true,
'disable_scrolling' => false,
'expand_on_play' => true,
'minimize_on_pause' => false,
'mobile' => true,
'enabled' => true
],
'traffic_filter' => [
'fallback_video_id' => '507f191e810c19729de860ea',
'token' => 'gate_7f3c1a',
'languages' => [
'pt',
'en'
],
'countries' => [
'BR',
'US'
],
'devices' => [
'desktop',
'mobile'
],
'query_params' => [
'utm_source'
],
'block_proxy' => true,
'enabled' => true
],
'playback' => [
'disable_pause' => false,
'smart_pause' => true,
'scroll_to_action_in' => 30,
'action_after_finish' => [
'type' => 'loop',
'start' => 5
],
'enabled' => true
],
'progress_bar' => [
'height' => 12,
'use_base_color' => false,
'color' => '#0000FF',
'enabled' => true
],
'subtitle' => [
'control' => true,
'style' => [
'font_size' => '16px',
'color' => '#FFFFFF',
'background_color' => '#000000',
'text_align' => 'center',
'show_by_default' => true
],
'enabled' => true,
'track' => [
'file_id' => '0190a0b0-2222-7222-8222-222222222222'
]
],
'resume' => [
'disable_pause' => false,
'styles' => [
'background_color' => '#1890FF',
'foreground_color' => '#FFFFFF'
],
'texts' => [
'play' => 'Keep watching',
'replay' => 'Replay',
'title' => 'You already started'
],
'enabled' => true
],
'call_actions' => [
'enabled' => true,
'items' => [
[
'base' => [
'type' => 'outside_video',
'active' => true
],
'window' => [
'start' => 5,
'end' => 30
],
'action' => [
'content' => 'Buy now',
'url' => 'https://example.com/checkout',
'open_in_new_tab' => true
],
'design' => [
'typography' => [
'family' => 'Inter',
'letter_spacing' => 0,
'line_height' => 1.2,
'size' => 16,
'weight' => 600
],
'styles' => [
'background_color' => '#1890FF',
'background_hover_color' => '#096DD9',
'text_color' => '#FFFFFF',
'text_hover_color' => '#F0F0F0',
'border_radius' => 8,
'shadow_enabled' => true,
'shadow' => [
'blur' => 12,
'color' => '#00000040',
'horizontal' => 0,
'vertical' => 4,
'spread' => 2
],
'padding' => [
'binding' => true,
'values' => [
12,
24,
12,
24
]
]
]
]
]
]
],
'smart_autoplay' => [
'enabled' => true,
'variants' => [
[
'template_name' => 'discrete',
'template_position' => 'top-left'
]
]
],
'pixels' => [
'items' => [
[
'base' => [
'name' => 'Fresh',
'type' => 'custom'
],
'tag' => [
'html' => '<div>tag</div>'
],
'dispatch' => [
'active' => true,
'threshold' => 50,
'mode' => 'percent'
]
]
],
'enabled' => true
],
'turbo' => [
'enabled' => true,
'speed' => 1.5
],
'headline' => [
'variants' => [
[
'id' => '652f2b1e8f1b2c3d4e5f0201',
'base' => [
'name' => 'Renamed'
]
],
[
'base' => [
'number' => 3
],
'content' => [
'kind' => 'html',
'html' => '<h1>New</h1>'
]
],
[
'id' => '652f2b1e8f1b2c3d4e5f0202',
'_destroy' => true
]
]
],
'name' => 'Renamed',
'description' => 'New copy',
'folder_id' => '652f2b1e8f1b2c3d4e5f00aa',
'mini_hooks' => [
'elements' => [
[
'id' => '652f2b1e8f1b2c3d4e5f0016',
'content' => [
'src_file_id' => '0190a0b0-3333-7333-8333-333333333333'
]
]
]
],
'thumbsniper' => [
'images' => [
'start_file_id' => '0190a0b0-1111-7111-8111-111111111111',
'pause_file_id' => '0190a0b0-1111-7111-8111-111111111111',
'finish_file_id' => '0190a0b0-1111-7111-8111-111111111111'
],
'cards' => [
[
'base' => [
'image_file_id' => '0190a0b0-1111-7111-8111-111111111111'
]
]
]
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.vturb.com/v1/videos/{id}"
payload := strings.NewReader("{\n \"controls\": {\n \"backward\": true,\n \"big_play\": false,\n \"forward\": true,\n \"fullscreen\": true,\n \"play_pause\": true,\n \"seekbar\": true,\n \"time\": true,\n \"volume\": true,\n \"fake_bar\": false,\n \"speed\": true\n },\n \"alternative_video\": {\n \"enabled\": true,\n \"id\": \"507f191e810c19729de860ea\"\n },\n \"immersive_mode\": {\n \"desktop\": true,\n \"disable_scrolling\": false,\n \"expand_on_play\": true,\n \"minimize_on_pause\": false,\n \"mobile\": true,\n \"enabled\": true\n },\n \"traffic_filter\": {\n \"fallback_video_id\": \"507f191e810c19729de860ea\",\n \"token\": \"gate_7f3c1a\",\n \"languages\": [\n \"pt\",\n \"en\"\n ],\n \"countries\": [\n \"BR\",\n \"US\"\n ],\n \"devices\": [\n \"desktop\",\n \"mobile\"\n ],\n \"query_params\": [\n \"utm_source\"\n ],\n \"block_proxy\": true,\n \"enabled\": true\n },\n \"playback\": {\n \"disable_pause\": false,\n \"smart_pause\": true,\n \"scroll_to_action_in\": 30,\n \"action_after_finish\": {\n \"type\": \"loop\",\n \"start\": 5\n },\n \"enabled\": true\n },\n \"progress_bar\": {\n \"height\": 12,\n \"use_base_color\": false,\n \"color\": \"#0000FF\",\n \"enabled\": true\n },\n \"subtitle\": {\n \"control\": true,\n \"style\": {\n \"font_size\": \"16px\",\n \"color\": \"#FFFFFF\",\n \"background_color\": \"#000000\",\n \"text_align\": \"center\",\n \"show_by_default\": true\n },\n \"enabled\": true,\n \"track\": {\n \"file_id\": \"0190a0b0-2222-7222-8222-222222222222\"\n }\n },\n \"resume\": {\n \"disable_pause\": false,\n \"styles\": {\n \"background_color\": \"#1890FF\",\n \"foreground_color\": \"#FFFFFF\"\n },\n \"texts\": {\n \"play\": \"Keep watching\",\n \"replay\": \"Replay\",\n \"title\": \"You already started\"\n },\n \"enabled\": true\n },\n \"call_actions\": {\n \"enabled\": true,\n \"items\": [\n {\n \"base\": {\n \"type\": \"outside_video\",\n \"active\": true\n },\n \"window\": {\n \"start\": 5,\n \"end\": 30\n },\n \"action\": {\n \"content\": \"Buy now\",\n \"url\": \"https://example.com/checkout\",\n \"open_in_new_tab\": true\n },\n \"design\": {\n \"typography\": {\n \"family\": \"Inter\",\n \"letter_spacing\": 0,\n \"line_height\": 1.2,\n \"size\": 16,\n \"weight\": 600\n },\n \"styles\": {\n \"background_color\": \"#1890FF\",\n \"background_hover_color\": \"#096DD9\",\n \"text_color\": \"#FFFFFF\",\n \"text_hover_color\": \"#F0F0F0\",\n \"border_radius\": 8,\n \"shadow_enabled\": true,\n \"shadow\": {\n \"blur\": 12,\n \"color\": \"#00000040\",\n \"horizontal\": 0,\n \"vertical\": 4,\n \"spread\": 2\n },\n \"padding\": {\n \"binding\": true,\n \"values\": [\n 12,\n 24,\n 12,\n 24\n ]\n }\n }\n }\n }\n ]\n },\n \"smart_autoplay\": {\n \"enabled\": true,\n \"variants\": [\n {\n \"template_name\": \"discrete\",\n \"template_position\": \"top-left\"\n }\n ]\n },\n \"pixels\": {\n \"items\": [\n {\n \"base\": {\n \"name\": \"Fresh\",\n \"type\": \"custom\"\n },\n \"tag\": {\n \"html\": \"<div>tag</div>\"\n },\n \"dispatch\": {\n \"active\": true,\n \"threshold\": 50,\n \"mode\": \"percent\"\n }\n }\n ],\n \"enabled\": true\n },\n \"turbo\": {\n \"enabled\": true,\n \"speed\": 1.5\n },\n \"headline\": {\n \"variants\": [\n {\n \"id\": \"652f2b1e8f1b2c3d4e5f0201\",\n \"base\": {\n \"name\": \"Renamed\"\n }\n },\n {\n \"base\": {\n \"number\": 3\n },\n \"content\": {\n \"kind\": \"html\",\n \"html\": \"<h1>New</h1>\"\n }\n },\n {\n \"id\": \"652f2b1e8f1b2c3d4e5f0202\",\n \"_destroy\": true\n }\n ]\n },\n \"name\": \"Renamed\",\n \"description\": \"New copy\",\n \"folder_id\": \"652f2b1e8f1b2c3d4e5f00aa\",\n \"mini_hooks\": {\n \"elements\": [\n {\n \"id\": \"652f2b1e8f1b2c3d4e5f0016\",\n \"content\": {\n \"src_file_id\": \"0190a0b0-3333-7333-8333-333333333333\"\n }\n }\n ]\n },\n \"thumbsniper\": {\n \"images\": {\n \"start_file_id\": \"0190a0b0-1111-7111-8111-111111111111\",\n \"pause_file_id\": \"0190a0b0-1111-7111-8111-111111111111\",\n \"finish_file_id\": \"0190a0b0-1111-7111-8111-111111111111\"\n },\n \"cards\": [\n {\n \"base\": {\n \"image_file_id\": \"0190a0b0-1111-7111-8111-111111111111\"\n }\n }\n ]\n }\n}")
req, _ := http.NewRequest("PATCH", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.patch("https://api.vturb.com/v1/videos/{id}")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"controls\": {\n \"backward\": true,\n \"big_play\": false,\n \"forward\": true,\n \"fullscreen\": true,\n \"play_pause\": true,\n \"seekbar\": true,\n \"time\": true,\n \"volume\": true,\n \"fake_bar\": false,\n \"speed\": true\n },\n \"alternative_video\": {\n \"enabled\": true,\n \"id\": \"507f191e810c19729de860ea\"\n },\n \"immersive_mode\": {\n \"desktop\": true,\n \"disable_scrolling\": false,\n \"expand_on_play\": true,\n \"minimize_on_pause\": false,\n \"mobile\": true,\n \"enabled\": true\n },\n \"traffic_filter\": {\n \"fallback_video_id\": \"507f191e810c19729de860ea\",\n \"token\": \"gate_7f3c1a\",\n \"languages\": [\n \"pt\",\n \"en\"\n ],\n \"countries\": [\n \"BR\",\n \"US\"\n ],\n \"devices\": [\n \"desktop\",\n \"mobile\"\n ],\n \"query_params\": [\n \"utm_source\"\n ],\n \"block_proxy\": true,\n \"enabled\": true\n },\n \"playback\": {\n \"disable_pause\": false,\n \"smart_pause\": true,\n \"scroll_to_action_in\": 30,\n \"action_after_finish\": {\n \"type\": \"loop\",\n \"start\": 5\n },\n \"enabled\": true\n },\n \"progress_bar\": {\n \"height\": 12,\n \"use_base_color\": false,\n \"color\": \"#0000FF\",\n \"enabled\": true\n },\n \"subtitle\": {\n \"control\": true,\n \"style\": {\n \"font_size\": \"16px\",\n \"color\": \"#FFFFFF\",\n \"background_color\": \"#000000\",\n \"text_align\": \"center\",\n \"show_by_default\": true\n },\n \"enabled\": true,\n \"track\": {\n \"file_id\": \"0190a0b0-2222-7222-8222-222222222222\"\n }\n },\n \"resume\": {\n \"disable_pause\": false,\n \"styles\": {\n \"background_color\": \"#1890FF\",\n \"foreground_color\": \"#FFFFFF\"\n },\n \"texts\": {\n \"play\": \"Keep watching\",\n \"replay\": \"Replay\",\n \"title\": \"You already started\"\n },\n \"enabled\": true\n },\n \"call_actions\": {\n \"enabled\": true,\n \"items\": [\n {\n \"base\": {\n \"type\": \"outside_video\",\n \"active\": true\n },\n \"window\": {\n \"start\": 5,\n \"end\": 30\n },\n \"action\": {\n \"content\": \"Buy now\",\n \"url\": \"https://example.com/checkout\",\n \"open_in_new_tab\": true\n },\n \"design\": {\n \"typography\": {\n \"family\": \"Inter\",\n \"letter_spacing\": 0,\n \"line_height\": 1.2,\n \"size\": 16,\n \"weight\": 600\n },\n \"styles\": {\n \"background_color\": \"#1890FF\",\n \"background_hover_color\": \"#096DD9\",\n \"text_color\": \"#FFFFFF\",\n \"text_hover_color\": \"#F0F0F0\",\n \"border_radius\": 8,\n \"shadow_enabled\": true,\n \"shadow\": {\n \"blur\": 12,\n \"color\": \"#00000040\",\n \"horizontal\": 0,\n \"vertical\": 4,\n \"spread\": 2\n },\n \"padding\": {\n \"binding\": true,\n \"values\": [\n 12,\n 24,\n 12,\n 24\n ]\n }\n }\n }\n }\n ]\n },\n \"smart_autoplay\": {\n \"enabled\": true,\n \"variants\": [\n {\n \"template_name\": \"discrete\",\n \"template_position\": \"top-left\"\n }\n ]\n },\n \"pixels\": {\n \"items\": [\n {\n \"base\": {\n \"name\": \"Fresh\",\n \"type\": \"custom\"\n },\n \"tag\": {\n \"html\": \"<div>tag</div>\"\n },\n \"dispatch\": {\n \"active\": true,\n \"threshold\": 50,\n \"mode\": \"percent\"\n }\n }\n ],\n \"enabled\": true\n },\n \"turbo\": {\n \"enabled\": true,\n \"speed\": 1.5\n },\n \"headline\": {\n \"variants\": [\n {\n \"id\": \"652f2b1e8f1b2c3d4e5f0201\",\n \"base\": {\n \"name\": \"Renamed\"\n }\n },\n {\n \"base\": {\n \"number\": 3\n },\n \"content\": {\n \"kind\": \"html\",\n \"html\": \"<h1>New</h1>\"\n }\n },\n {\n \"id\": \"652f2b1e8f1b2c3d4e5f0202\",\n \"_destroy\": true\n }\n ]\n },\n \"name\": \"Renamed\",\n \"description\": \"New copy\",\n \"folder_id\": \"652f2b1e8f1b2c3d4e5f00aa\",\n \"mini_hooks\": {\n \"elements\": [\n {\n \"id\": \"652f2b1e8f1b2c3d4e5f0016\",\n \"content\": {\n \"src_file_id\": \"0190a0b0-3333-7333-8333-333333333333\"\n }\n }\n ]\n },\n \"thumbsniper\": {\n \"images\": {\n \"start_file_id\": \"0190a0b0-1111-7111-8111-111111111111\",\n \"pause_file_id\": \"0190a0b0-1111-7111-8111-111111111111\",\n \"finish_file_id\": \"0190a0b0-1111-7111-8111-111111111111\"\n },\n \"cards\": [\n {\n \"base\": {\n \"image_file_id\": \"0190a0b0-1111-7111-8111-111111111111\"\n }\n }\n ]\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.vturb.com/v1/videos/{id}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Patch.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"controls\": {\n \"backward\": true,\n \"big_play\": false,\n \"forward\": true,\n \"fullscreen\": true,\n \"play_pause\": true,\n \"seekbar\": true,\n \"time\": true,\n \"volume\": true,\n \"fake_bar\": false,\n \"speed\": true\n },\n \"alternative_video\": {\n \"enabled\": true,\n \"id\": \"507f191e810c19729de860ea\"\n },\n \"immersive_mode\": {\n \"desktop\": true,\n \"disable_scrolling\": false,\n \"expand_on_play\": true,\n \"minimize_on_pause\": false,\n \"mobile\": true,\n \"enabled\": true\n },\n \"traffic_filter\": {\n \"fallback_video_id\": \"507f191e810c19729de860ea\",\n \"token\": \"gate_7f3c1a\",\n \"languages\": [\n \"pt\",\n \"en\"\n ],\n \"countries\": [\n \"BR\",\n \"US\"\n ],\n \"devices\": [\n \"desktop\",\n \"mobile\"\n ],\n \"query_params\": [\n \"utm_source\"\n ],\n \"block_proxy\": true,\n \"enabled\": true\n },\n \"playback\": {\n \"disable_pause\": false,\n \"smart_pause\": true,\n \"scroll_to_action_in\": 30,\n \"action_after_finish\": {\n \"type\": \"loop\",\n \"start\": 5\n },\n \"enabled\": true\n },\n \"progress_bar\": {\n \"height\": 12,\n \"use_base_color\": false,\n \"color\": \"#0000FF\",\n \"enabled\": true\n },\n \"subtitle\": {\n \"control\": true,\n \"style\": {\n \"font_size\": \"16px\",\n \"color\": \"#FFFFFF\",\n \"background_color\": \"#000000\",\n \"text_align\": \"center\",\n \"show_by_default\": true\n },\n \"enabled\": true,\n \"track\": {\n \"file_id\": \"0190a0b0-2222-7222-8222-222222222222\"\n }\n },\n \"resume\": {\n \"disable_pause\": false,\n \"styles\": {\n \"background_color\": \"#1890FF\",\n \"foreground_color\": \"#FFFFFF\"\n },\n \"texts\": {\n \"play\": \"Keep watching\",\n \"replay\": \"Replay\",\n \"title\": \"You already started\"\n },\n \"enabled\": true\n },\n \"call_actions\": {\n \"enabled\": true,\n \"items\": [\n {\n \"base\": {\n \"type\": \"outside_video\",\n \"active\": true\n },\n \"window\": {\n \"start\": 5,\n \"end\": 30\n },\n \"action\": {\n \"content\": \"Buy now\",\n \"url\": \"https://example.com/checkout\",\n \"open_in_new_tab\": true\n },\n \"design\": {\n \"typography\": {\n \"family\": \"Inter\",\n \"letter_spacing\": 0,\n \"line_height\": 1.2,\n \"size\": 16,\n \"weight\": 600\n },\n \"styles\": {\n \"background_color\": \"#1890FF\",\n \"background_hover_color\": \"#096DD9\",\n \"text_color\": \"#FFFFFF\",\n \"text_hover_color\": \"#F0F0F0\",\n \"border_radius\": 8,\n \"shadow_enabled\": true,\n \"shadow\": {\n \"blur\": 12,\n \"color\": \"#00000040\",\n \"horizontal\": 0,\n \"vertical\": 4,\n \"spread\": 2\n },\n \"padding\": {\n \"binding\": true,\n \"values\": [\n 12,\n 24,\n 12,\n 24\n ]\n }\n }\n }\n }\n ]\n },\n \"smart_autoplay\": {\n \"enabled\": true,\n \"variants\": [\n {\n \"template_name\": \"discrete\",\n \"template_position\": \"top-left\"\n }\n ]\n },\n \"pixels\": {\n \"items\": [\n {\n \"base\": {\n \"name\": \"Fresh\",\n \"type\": \"custom\"\n },\n \"tag\": {\n \"html\": \"<div>tag</div>\"\n },\n \"dispatch\": {\n \"active\": true,\n \"threshold\": 50,\n \"mode\": \"percent\"\n }\n }\n ],\n \"enabled\": true\n },\n \"turbo\": {\n \"enabled\": true,\n \"speed\": 1.5\n },\n \"headline\": {\n \"variants\": [\n {\n \"id\": \"652f2b1e8f1b2c3d4e5f0201\",\n \"base\": {\n \"name\": \"Renamed\"\n }\n },\n {\n \"base\": {\n \"number\": 3\n },\n \"content\": {\n \"kind\": \"html\",\n \"html\": \"<h1>New</h1>\"\n }\n },\n {\n \"id\": \"652f2b1e8f1b2c3d4e5f0202\",\n \"_destroy\": true\n }\n ]\n },\n \"name\": \"Renamed\",\n \"description\": \"New copy\",\n \"folder_id\": \"652f2b1e8f1b2c3d4e5f00aa\",\n \"mini_hooks\": {\n \"elements\": [\n {\n \"id\": \"652f2b1e8f1b2c3d4e5f0016\",\n \"content\": {\n \"src_file_id\": \"0190a0b0-3333-7333-8333-333333333333\"\n }\n }\n ]\n },\n \"thumbsniper\": {\n \"images\": {\n \"start_file_id\": \"0190a0b0-1111-7111-8111-111111111111\",\n \"pause_file_id\": \"0190a0b0-1111-7111-8111-111111111111\",\n \"finish_file_id\": \"0190a0b0-1111-7111-8111-111111111111\"\n },\n \"cards\": [\n {\n \"base\": {\n \"image_file_id\": \"0190a0b0-1111-7111-8111-111111111111\"\n }\n }\n ]\n }\n}"
response = http.request(request)
puts response.read_body{
"id": "652f2b1e8f1b2c3d4e5f6a7b",
"name": "Landing hero",
"description": null,
"folder_id": null,
"status": "processing",
"controls": {
"backward": null,
"big_play": null,
"forward": null,
"fullscreen": null,
"play_pause": null,
"seekbar": null,
"time": null,
"volume": null,
"fake_bar": null,
"speed": null
},
"call_actions": {
"enabled": false,
"items": []
},
"alternative_video": {
"enabled": null,
"id": null
},
"traffic_filter": {
"fallback_video_id": null,
"token": null,
"languages": null,
"countries": null,
"devices": null,
"query_params": null,
"block_proxy": null,
"enabled": null
},
"styles": {
"background_color": null,
"foreground_color": null,
"border_radius": null,
"linear_gradient": {
"angle": null,
"primary_color": null,
"primary_stop": null,
"secondary_color": null,
"secondary_stop": null,
"enabled": null
}
},
"general": {
"currency": null,
"pitch_time": null,
"preload_type": null,
"start_quality": null
},
"immersive_mode": {
"desktop": null,
"disable_scrolling": null,
"expand_on_play": null,
"minimize_on_pause": null,
"mobile": null,
"enabled": null
},
"mini_hooks": {
"elements": [],
"enabled": null
},
"pixels": {
"items": [],
"enabled": null
},
"playback": {
"disable_pause": null,
"scroll_to_action_in": null,
"smart_pause": null,
"action_after_finish": {
"type": null,
"start": null
},
"enabled": null
},
"subtitle": {
"control": null,
"track": {
"name": null,
"url": "https://static.vturb.com/assets/org_123/2026/08/12/0190a0b0-2222-7222-8222-222222222222/original.vtt"
},
"style": {
"font_size": null,
"color": null,
"background_color": null,
"text_align": null,
"bottom": null,
"max_width": null,
"show_by_default": null
},
"enabled": null
},
"thumbsniper": {
"background_color": null,
"images": {
"start": null,
"pause": null,
"finish": null
},
"cards": [],
"enabled": null
},
"turbo": {
"enabled": null,
"mode": "single",
"speed": null
},
"headline": {
"enabled": null,
"mode": "single",
"active_number": null,
"variants": []
},
"progress_bar": {
"height": null,
"use_base_color": null,
"current_color": null,
"color": null,
"enabled": null
},
"resume": {
"disable_pause": null,
"styles": {
"background_color": null,
"foreground_color": null
},
"texts": {
"play": null,
"replay": null,
"title": null
},
"enabled": null
},
"smart_autoplay": {
"enabled": null,
"mode": "single",
"active_number": null,
"variants": []
}
}{
"type": "https://docs.vturb.com/errors/bad_request",
"code": "bad_request",
"message": "The request includes fields this endpoint does not accept.",
"field": "unknown",
"request_id": "00000000-0000-0000-0000-000000000000"
}{
"type": "https://docs.vturb.com/errors/unauthorized",
"code": "unauthorized",
"message": "Missing or invalid API credential. Send a vt_ token in the Authorization header.",
"request_id": "00000000-0000-0000-0000-000000000000"
}{
"type": "https://docs.vturb.com/errors/forbidden",
"code": "forbidden",
"message": "The credential is missing the scope this action requires.",
"request_id": "00000000-0000-0000-0000-000000000000"
}{
"type": "https://docs.vturb.com/errors/not_found",
"code": "not_found",
"message": "Resource not found.",
"request_id": "00000000-0000-0000-0000-000000000000"
}{
"type": "https://docs.vturb.com/errors/unprocessable_content",
"code": "unprocessable_content",
"message": "The request is invalid. See errors for the fields that failed.",
"request_id": "00000000-0000-0000-0000-000000000000",
"errors": [
{
"field": "call_actions.items[0].window.start",
"message": "must be less than the end time"
},
{
"field": "call_actions.items[0].action.url",
"message": "must be present"
},
{
"field": "call_actions.items[0].action.content",
"message": "must be present"
},
{
"field": "call_actions.items[0].design.typography",
"message": "must be present"
},
{
"field": "call_actions.items[0].design.styles",
"message": "must be present"
}
]
}{
"type": "https://docs.vturb.com/errors/service_unavailable",
"code": "service_unavailable",
"message": "The service is temporarily unavailable. Retry shortly.",
"request_id": "00000000-0000-0000-0000-000000000000"
}Merge-patch by feature
The request body is grouped by player feature — controls, playback, turbo, smart_autoplay, pixels, and more. It is a merge-patch: send only the groups you want to change, and within a group only the keys you touch; everything else keeps its stored value. Each group is collapsed below — expand the ones you need. New here? How merge-patch works covers the rules in a page; every feature also has a focused guide under the Guides tab.Authorizations
Paste your VTurb API token (vt_...). Sent as Authorization: Bearer <token>.
Path Parameters
Body
application/json
Player chrome toggles — each key shows or hides one on-screen control. See the Update controls guide for a focused example.
Show child attributes
Show child attributes
Fallback video for viewers who can't play the main one. See the Update alternative video guide.
Show child attributes
Show child attributes
The fullscreen takeover — where it runs and when it expands. See the Update immersive mode guide.
Show child attributes
Show child attributes
Routes unwanted traffic — wrong country, wrong device, proxies — to a fallback video. See the Update traffic filter guide.
Show child attributes
Show child attributes
Pause behavior, the scroll-to-action moment, and what happens when the video ends. See the Update playback guide.
Show child attributes
Show child attributes
The decoy progress bar — height, color, and whether it borrows the player's palette. See the Update progress bar guide.
Show child attributes
Show child attributes
Caption toggle and styling; the track file itself is read-only. See the Update subtitle guide.
Show child attributes
Show child attributes
The keep-watching prompt returning viewers see — its copy and colors. See the Update resume guide.
Show child attributes
Show child attributes
CTA collection — an item with an id patches that CTA, without one creates it, with _destroy: true deletes it. See the Update call actions guide.
Show child attributes
Show child attributes
Muted-autoplay overlay — pick a template and a grid position. See the Update smart autoplay guide.
Show child attributes
Show child attributes
Tracking pixels and when in playback they fire — same id/_destroy collection semantics as CTAs. See the Update pixels guide.
Show child attributes
Show child attributes
Accelerated playback — the toggle and its rate; experiment leaves are read-only. See the Update turbo guide.
Show child attributes
Show child attributes
The headline variants drawn above the player — same id/_destroy collection semantics as CTAs. Configure at least two, then start the A/B test from the Experiments endpoint.
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Response
Send <leaf>_file_id with an uploaded file's id and the video stores that file's public url.
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Was this page helpful?
⌘I
Update a video
curl --request PATCH \
--url https://api.vturb.com/v1/videos/{id} \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"controls": {
"backward": true,
"big_play": false,
"forward": true,
"fullscreen": true,
"play_pause": true,
"seekbar": true,
"time": true,
"volume": true,
"fake_bar": false,
"speed": true
},
"alternative_video": {
"enabled": true,
"id": "507f191e810c19729de860ea"
},
"immersive_mode": {
"desktop": true,
"disable_scrolling": false,
"expand_on_play": true,
"minimize_on_pause": false,
"mobile": true,
"enabled": true
},
"traffic_filter": {
"fallback_video_id": "507f191e810c19729de860ea",
"token": "gate_7f3c1a",
"languages": [
"pt",
"en"
],
"countries": [
"BR",
"US"
],
"devices": [
"desktop",
"mobile"
],
"query_params": [
"utm_source"
],
"block_proxy": true,
"enabled": true
},
"playback": {
"disable_pause": false,
"smart_pause": true,
"scroll_to_action_in": 30,
"action_after_finish": {
"type": "loop",
"start": 5
},
"enabled": true
},
"progress_bar": {
"height": 12,
"use_base_color": false,
"color": "#0000FF",
"enabled": true
},
"subtitle": {
"control": true,
"style": {
"font_size": "16px",
"color": "#FFFFFF",
"background_color": "#000000",
"text_align": "center",
"show_by_default": true
},
"enabled": true,
"track": {
"file_id": "0190a0b0-2222-7222-8222-222222222222"
}
},
"resume": {
"disable_pause": false,
"styles": {
"background_color": "#1890FF",
"foreground_color": "#FFFFFF"
},
"texts": {
"play": "Keep watching",
"replay": "Replay",
"title": "You already started"
},
"enabled": true
},
"call_actions": {
"enabled": true,
"items": [
{
"base": {
"type": "outside_video",
"active": true
},
"window": {
"start": 5,
"end": 30
},
"action": {
"content": "Buy now",
"url": "https://example.com/checkout",
"open_in_new_tab": true
},
"design": {
"typography": {
"family": "Inter",
"letter_spacing": 0,
"line_height": 1.2,
"size": 16,
"weight": 600
},
"styles": {
"background_color": "#1890FF",
"background_hover_color": "#096DD9",
"text_color": "#FFFFFF",
"text_hover_color": "#F0F0F0",
"border_radius": 8,
"shadow_enabled": true,
"shadow": {
"blur": 12,
"color": "#00000040",
"horizontal": 0,
"vertical": 4,
"spread": 2
},
"padding": {
"binding": true,
"values": [
12,
24,
12,
24
]
}
}
}
}
]
},
"smart_autoplay": {
"enabled": true,
"variants": [
{
"template_name": "discrete",
"template_position": "top-left"
}
]
},
"pixels": {
"items": [
{
"base": {
"name": "Fresh",
"type": "custom"
},
"tag": {
"html": "<div>tag</div>"
},
"dispatch": {
"active": true,
"threshold": 50,
"mode": "percent"
}
}
],
"enabled": true
},
"turbo": {
"enabled": true,
"speed": 1.5
},
"headline": {
"variants": [
{
"id": "652f2b1e8f1b2c3d4e5f0201",
"base": {
"name": "Renamed"
}
},
{
"base": {
"number": 3
},
"content": {
"kind": "html",
"html": "<h1>New</h1>"
}
},
{
"id": "652f2b1e8f1b2c3d4e5f0202",
"_destroy": true
}
]
},
"name": "Renamed",
"description": "New copy",
"folder_id": "652f2b1e8f1b2c3d4e5f00aa",
"mini_hooks": {
"elements": [
{
"id": "652f2b1e8f1b2c3d4e5f0016",
"content": {
"src_file_id": "0190a0b0-3333-7333-8333-333333333333"
}
}
]
},
"thumbsniper": {
"images": {
"start_file_id": "0190a0b0-1111-7111-8111-111111111111",
"pause_file_id": "0190a0b0-1111-7111-8111-111111111111",
"finish_file_id": "0190a0b0-1111-7111-8111-111111111111"
},
"cards": [
{
"base": {
"image_file_id": "0190a0b0-1111-7111-8111-111111111111"
}
}
]
}
}
'import requests
url = "https://api.vturb.com/v1/videos/{id}"
payload = {
"controls": {
"backward": True,
"big_play": False,
"forward": True,
"fullscreen": True,
"play_pause": True,
"seekbar": True,
"time": True,
"volume": True,
"fake_bar": False,
"speed": True
},
"alternative_video": {
"enabled": True,
"id": "507f191e810c19729de860ea"
},
"immersive_mode": {
"desktop": True,
"disable_scrolling": False,
"expand_on_play": True,
"minimize_on_pause": False,
"mobile": True,
"enabled": True
},
"traffic_filter": {
"fallback_video_id": "507f191e810c19729de860ea",
"token": "gate_7f3c1a",
"languages": ["pt", "en"],
"countries": ["BR", "US"],
"devices": ["desktop", "mobile"],
"query_params": ["utm_source"],
"block_proxy": True,
"enabled": True
},
"playback": {
"disable_pause": False,
"smart_pause": True,
"scroll_to_action_in": 30,
"action_after_finish": {
"type": "loop",
"start": 5
},
"enabled": True
},
"progress_bar": {
"height": 12,
"use_base_color": False,
"color": "#0000FF",
"enabled": True
},
"subtitle": {
"control": True,
"style": {
"font_size": "16px",
"color": "#FFFFFF",
"background_color": "#000000",
"text_align": "center",
"show_by_default": True
},
"enabled": True,
"track": { "file_id": "0190a0b0-2222-7222-8222-222222222222" }
},
"resume": {
"disable_pause": False,
"styles": {
"background_color": "#1890FF",
"foreground_color": "#FFFFFF"
},
"texts": {
"play": "Keep watching",
"replay": "Replay",
"title": "You already started"
},
"enabled": True
},
"call_actions": {
"enabled": True,
"items": [
{
"base": {
"type": "outside_video",
"active": True
},
"window": {
"start": 5,
"end": 30
},
"action": {
"content": "Buy now",
"url": "https://example.com/checkout",
"open_in_new_tab": True
},
"design": {
"typography": {
"family": "Inter",
"letter_spacing": 0,
"line_height": 1.2,
"size": 16,
"weight": 600
},
"styles": {
"background_color": "#1890FF",
"background_hover_color": "#096DD9",
"text_color": "#FFFFFF",
"text_hover_color": "#F0F0F0",
"border_radius": 8,
"shadow_enabled": True,
"shadow": {
"blur": 12,
"color": "#00000040",
"horizontal": 0,
"vertical": 4,
"spread": 2
},
"padding": {
"binding": True,
"values": [12, 24, 12, 24]
}
}
}
}
]
},
"smart_autoplay": {
"enabled": True,
"variants": [
{
"template_name": "discrete",
"template_position": "top-left"
}
]
},
"pixels": {
"items": [
{
"base": {
"name": "Fresh",
"type": "custom"
},
"tag": { "html": "<div>tag</div>" },
"dispatch": {
"active": True,
"threshold": 50,
"mode": "percent"
}
}
],
"enabled": True
},
"turbo": {
"enabled": True,
"speed": 1.5
},
"headline": { "variants": [
{
"id": "652f2b1e8f1b2c3d4e5f0201",
"base": { "name": "Renamed" }
},
{
"base": { "number": 3 },
"content": {
"kind": "html",
"html": "<h1>New</h1>"
}
},
{
"id": "652f2b1e8f1b2c3d4e5f0202",
"_destroy": True
}
] },
"name": "Renamed",
"description": "New copy",
"folder_id": "652f2b1e8f1b2c3d4e5f00aa",
"mini_hooks": { "elements": [
{
"id": "652f2b1e8f1b2c3d4e5f0016",
"content": { "src_file_id": "0190a0b0-3333-7333-8333-333333333333" }
}
] },
"thumbsniper": {
"images": {
"start_file_id": "0190a0b0-1111-7111-8111-111111111111",
"pause_file_id": "0190a0b0-1111-7111-8111-111111111111",
"finish_file_id": "0190a0b0-1111-7111-8111-111111111111"
},
"cards": [{ "base": { "image_file_id": "0190a0b0-1111-7111-8111-111111111111" } }]
}
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.patch(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PATCH',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
controls: {
backward: true,
big_play: false,
forward: true,
fullscreen: true,
play_pause: true,
seekbar: true,
time: true,
volume: true,
fake_bar: false,
speed: true
},
alternative_video: {enabled: true, id: '507f191e810c19729de860ea'},
immersive_mode: {
desktop: true,
disable_scrolling: false,
expand_on_play: true,
minimize_on_pause: false,
mobile: true,
enabled: true
},
traffic_filter: {
fallback_video_id: '507f191e810c19729de860ea',
token: 'gate_7f3c1a',
languages: ['pt', 'en'],
countries: ['BR', 'US'],
devices: ['desktop', 'mobile'],
query_params: ['utm_source'],
block_proxy: true,
enabled: true
},
playback: {
disable_pause: false,
smart_pause: true,
scroll_to_action_in: 30,
action_after_finish: {type: 'loop', start: 5},
enabled: true
},
progress_bar: {height: 12, use_base_color: false, color: '#0000FF', enabled: true},
subtitle: {
control: true,
style: {
font_size: '16px',
color: '#FFFFFF',
background_color: '#000000',
text_align: 'center',
show_by_default: true
},
enabled: true,
track: {file_id: '0190a0b0-2222-7222-8222-222222222222'}
},
resume: {
disable_pause: false,
styles: {background_color: '#1890FF', foreground_color: '#FFFFFF'},
texts: {play: 'Keep watching', replay: 'Replay', title: 'You already started'},
enabled: true
},
call_actions: {
enabled: true,
items: [
{
base: {type: 'outside_video', active: true},
window: {start: 5, end: 30},
action: {content: 'Buy now', url: 'https://example.com/checkout', open_in_new_tab: true},
design: {
typography: {family: 'Inter', letter_spacing: 0, line_height: 1.2, size: 16, weight: 600},
styles: {
background_color: '#1890FF',
background_hover_color: '#096DD9',
text_color: '#FFFFFF',
text_hover_color: '#F0F0F0',
border_radius: 8,
shadow_enabled: true,
shadow: {blur: 12, color: '#00000040', horizontal: 0, vertical: 4, spread: 2},
padding: {binding: true, values: [12, 24, 12, 24]}
}
}
}
]
},
smart_autoplay: {
enabled: true,
variants: [{template_name: 'discrete', template_position: 'top-left'}]
},
pixels: {
items: [
{
base: {name: 'Fresh', type: 'custom'},
tag: {html: '<div>tag</div>'},
dispatch: {active: true, threshold: 50, mode: 'percent'}
}
],
enabled: true
},
turbo: {enabled: true, speed: 1.5},
headline: {
variants: [
{id: '652f2b1e8f1b2c3d4e5f0201', base: {name: 'Renamed'}},
{base: {number: 3}, content: {kind: 'html', html: '<h1>New</h1>'}},
{id: '652f2b1e8f1b2c3d4e5f0202', _destroy: true}
]
},
name: 'Renamed',
description: 'New copy',
folder_id: '652f2b1e8f1b2c3d4e5f00aa',
mini_hooks: {
elements: [
{
id: '652f2b1e8f1b2c3d4e5f0016',
content: {src_file_id: '0190a0b0-3333-7333-8333-333333333333'}
}
]
},
thumbsniper: {
images: {
start_file_id: '0190a0b0-1111-7111-8111-111111111111',
pause_file_id: '0190a0b0-1111-7111-8111-111111111111',
finish_file_id: '0190a0b0-1111-7111-8111-111111111111'
},
cards: [{base: {image_file_id: '0190a0b0-1111-7111-8111-111111111111'}}]
}
})
};
fetch('https://api.vturb.com/v1/videos/{id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.vturb.com/v1/videos/{id}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "PATCH",
CURLOPT_POSTFIELDS => json_encode([
'controls' => [
'backward' => true,
'big_play' => false,
'forward' => true,
'fullscreen' => true,
'play_pause' => true,
'seekbar' => true,
'time' => true,
'volume' => true,
'fake_bar' => false,
'speed' => true
],
'alternative_video' => [
'enabled' => true,
'id' => '507f191e810c19729de860ea'
],
'immersive_mode' => [
'desktop' => true,
'disable_scrolling' => false,
'expand_on_play' => true,
'minimize_on_pause' => false,
'mobile' => true,
'enabled' => true
],
'traffic_filter' => [
'fallback_video_id' => '507f191e810c19729de860ea',
'token' => 'gate_7f3c1a',
'languages' => [
'pt',
'en'
],
'countries' => [
'BR',
'US'
],
'devices' => [
'desktop',
'mobile'
],
'query_params' => [
'utm_source'
],
'block_proxy' => true,
'enabled' => true
],
'playback' => [
'disable_pause' => false,
'smart_pause' => true,
'scroll_to_action_in' => 30,
'action_after_finish' => [
'type' => 'loop',
'start' => 5
],
'enabled' => true
],
'progress_bar' => [
'height' => 12,
'use_base_color' => false,
'color' => '#0000FF',
'enabled' => true
],
'subtitle' => [
'control' => true,
'style' => [
'font_size' => '16px',
'color' => '#FFFFFF',
'background_color' => '#000000',
'text_align' => 'center',
'show_by_default' => true
],
'enabled' => true,
'track' => [
'file_id' => '0190a0b0-2222-7222-8222-222222222222'
]
],
'resume' => [
'disable_pause' => false,
'styles' => [
'background_color' => '#1890FF',
'foreground_color' => '#FFFFFF'
],
'texts' => [
'play' => 'Keep watching',
'replay' => 'Replay',
'title' => 'You already started'
],
'enabled' => true
],
'call_actions' => [
'enabled' => true,
'items' => [
[
'base' => [
'type' => 'outside_video',
'active' => true
],
'window' => [
'start' => 5,
'end' => 30
],
'action' => [
'content' => 'Buy now',
'url' => 'https://example.com/checkout',
'open_in_new_tab' => true
],
'design' => [
'typography' => [
'family' => 'Inter',
'letter_spacing' => 0,
'line_height' => 1.2,
'size' => 16,
'weight' => 600
],
'styles' => [
'background_color' => '#1890FF',
'background_hover_color' => '#096DD9',
'text_color' => '#FFFFFF',
'text_hover_color' => '#F0F0F0',
'border_radius' => 8,
'shadow_enabled' => true,
'shadow' => [
'blur' => 12,
'color' => '#00000040',
'horizontal' => 0,
'vertical' => 4,
'spread' => 2
],
'padding' => [
'binding' => true,
'values' => [
12,
24,
12,
24
]
]
]
]
]
]
],
'smart_autoplay' => [
'enabled' => true,
'variants' => [
[
'template_name' => 'discrete',
'template_position' => 'top-left'
]
]
],
'pixels' => [
'items' => [
[
'base' => [
'name' => 'Fresh',
'type' => 'custom'
],
'tag' => [
'html' => '<div>tag</div>'
],
'dispatch' => [
'active' => true,
'threshold' => 50,
'mode' => 'percent'
]
]
],
'enabled' => true
],
'turbo' => [
'enabled' => true,
'speed' => 1.5
],
'headline' => [
'variants' => [
[
'id' => '652f2b1e8f1b2c3d4e5f0201',
'base' => [
'name' => 'Renamed'
]
],
[
'base' => [
'number' => 3
],
'content' => [
'kind' => 'html',
'html' => '<h1>New</h1>'
]
],
[
'id' => '652f2b1e8f1b2c3d4e5f0202',
'_destroy' => true
]
]
],
'name' => 'Renamed',
'description' => 'New copy',
'folder_id' => '652f2b1e8f1b2c3d4e5f00aa',
'mini_hooks' => [
'elements' => [
[
'id' => '652f2b1e8f1b2c3d4e5f0016',
'content' => [
'src_file_id' => '0190a0b0-3333-7333-8333-333333333333'
]
]
]
],
'thumbsniper' => [
'images' => [
'start_file_id' => '0190a0b0-1111-7111-8111-111111111111',
'pause_file_id' => '0190a0b0-1111-7111-8111-111111111111',
'finish_file_id' => '0190a0b0-1111-7111-8111-111111111111'
],
'cards' => [
[
'base' => [
'image_file_id' => '0190a0b0-1111-7111-8111-111111111111'
]
]
]
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.vturb.com/v1/videos/{id}"
payload := strings.NewReader("{\n \"controls\": {\n \"backward\": true,\n \"big_play\": false,\n \"forward\": true,\n \"fullscreen\": true,\n \"play_pause\": true,\n \"seekbar\": true,\n \"time\": true,\n \"volume\": true,\n \"fake_bar\": false,\n \"speed\": true\n },\n \"alternative_video\": {\n \"enabled\": true,\n \"id\": \"507f191e810c19729de860ea\"\n },\n \"immersive_mode\": {\n \"desktop\": true,\n \"disable_scrolling\": false,\n \"expand_on_play\": true,\n \"minimize_on_pause\": false,\n \"mobile\": true,\n \"enabled\": true\n },\n \"traffic_filter\": {\n \"fallback_video_id\": \"507f191e810c19729de860ea\",\n \"token\": \"gate_7f3c1a\",\n \"languages\": [\n \"pt\",\n \"en\"\n ],\n \"countries\": [\n \"BR\",\n \"US\"\n ],\n \"devices\": [\n \"desktop\",\n \"mobile\"\n ],\n \"query_params\": [\n \"utm_source\"\n ],\n \"block_proxy\": true,\n \"enabled\": true\n },\n \"playback\": {\n \"disable_pause\": false,\n \"smart_pause\": true,\n \"scroll_to_action_in\": 30,\n \"action_after_finish\": {\n \"type\": \"loop\",\n \"start\": 5\n },\n \"enabled\": true\n },\n \"progress_bar\": {\n \"height\": 12,\n \"use_base_color\": false,\n \"color\": \"#0000FF\",\n \"enabled\": true\n },\n \"subtitle\": {\n \"control\": true,\n \"style\": {\n \"font_size\": \"16px\",\n \"color\": \"#FFFFFF\",\n \"background_color\": \"#000000\",\n \"text_align\": \"center\",\n \"show_by_default\": true\n },\n \"enabled\": true,\n \"track\": {\n \"file_id\": \"0190a0b0-2222-7222-8222-222222222222\"\n }\n },\n \"resume\": {\n \"disable_pause\": false,\n \"styles\": {\n \"background_color\": \"#1890FF\",\n \"foreground_color\": \"#FFFFFF\"\n },\n \"texts\": {\n \"play\": \"Keep watching\",\n \"replay\": \"Replay\",\n \"title\": \"You already started\"\n },\n \"enabled\": true\n },\n \"call_actions\": {\n \"enabled\": true,\n \"items\": [\n {\n \"base\": {\n \"type\": \"outside_video\",\n \"active\": true\n },\n \"window\": {\n \"start\": 5,\n \"end\": 30\n },\n \"action\": {\n \"content\": \"Buy now\",\n \"url\": \"https://example.com/checkout\",\n \"open_in_new_tab\": true\n },\n \"design\": {\n \"typography\": {\n \"family\": \"Inter\",\n \"letter_spacing\": 0,\n \"line_height\": 1.2,\n \"size\": 16,\n \"weight\": 600\n },\n \"styles\": {\n \"background_color\": \"#1890FF\",\n \"background_hover_color\": \"#096DD9\",\n \"text_color\": \"#FFFFFF\",\n \"text_hover_color\": \"#F0F0F0\",\n \"border_radius\": 8,\n \"shadow_enabled\": true,\n \"shadow\": {\n \"blur\": 12,\n \"color\": \"#00000040\",\n \"horizontal\": 0,\n \"vertical\": 4,\n \"spread\": 2\n },\n \"padding\": {\n \"binding\": true,\n \"values\": [\n 12,\n 24,\n 12,\n 24\n ]\n }\n }\n }\n }\n ]\n },\n \"smart_autoplay\": {\n \"enabled\": true,\n \"variants\": [\n {\n \"template_name\": \"discrete\",\n \"template_position\": \"top-left\"\n }\n ]\n },\n \"pixels\": {\n \"items\": [\n {\n \"base\": {\n \"name\": \"Fresh\",\n \"type\": \"custom\"\n },\n \"tag\": {\n \"html\": \"<div>tag</div>\"\n },\n \"dispatch\": {\n \"active\": true,\n \"threshold\": 50,\n \"mode\": \"percent\"\n }\n }\n ],\n \"enabled\": true\n },\n \"turbo\": {\n \"enabled\": true,\n \"speed\": 1.5\n },\n \"headline\": {\n \"variants\": [\n {\n \"id\": \"652f2b1e8f1b2c3d4e5f0201\",\n \"base\": {\n \"name\": \"Renamed\"\n }\n },\n {\n \"base\": {\n \"number\": 3\n },\n \"content\": {\n \"kind\": \"html\",\n \"html\": \"<h1>New</h1>\"\n }\n },\n {\n \"id\": \"652f2b1e8f1b2c3d4e5f0202\",\n \"_destroy\": true\n }\n ]\n },\n \"name\": \"Renamed\",\n \"description\": \"New copy\",\n \"folder_id\": \"652f2b1e8f1b2c3d4e5f00aa\",\n \"mini_hooks\": {\n \"elements\": [\n {\n \"id\": \"652f2b1e8f1b2c3d4e5f0016\",\n \"content\": {\n \"src_file_id\": \"0190a0b0-3333-7333-8333-333333333333\"\n }\n }\n ]\n },\n \"thumbsniper\": {\n \"images\": {\n \"start_file_id\": \"0190a0b0-1111-7111-8111-111111111111\",\n \"pause_file_id\": \"0190a0b0-1111-7111-8111-111111111111\",\n \"finish_file_id\": \"0190a0b0-1111-7111-8111-111111111111\"\n },\n \"cards\": [\n {\n \"base\": {\n \"image_file_id\": \"0190a0b0-1111-7111-8111-111111111111\"\n }\n }\n ]\n }\n}")
req, _ := http.NewRequest("PATCH", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.patch("https://api.vturb.com/v1/videos/{id}")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"controls\": {\n \"backward\": true,\n \"big_play\": false,\n \"forward\": true,\n \"fullscreen\": true,\n \"play_pause\": true,\n \"seekbar\": true,\n \"time\": true,\n \"volume\": true,\n \"fake_bar\": false,\n \"speed\": true\n },\n \"alternative_video\": {\n \"enabled\": true,\n \"id\": \"507f191e810c19729de860ea\"\n },\n \"immersive_mode\": {\n \"desktop\": true,\n \"disable_scrolling\": false,\n \"expand_on_play\": true,\n \"minimize_on_pause\": false,\n \"mobile\": true,\n \"enabled\": true\n },\n \"traffic_filter\": {\n \"fallback_video_id\": \"507f191e810c19729de860ea\",\n \"token\": \"gate_7f3c1a\",\n \"languages\": [\n \"pt\",\n \"en\"\n ],\n \"countries\": [\n \"BR\",\n \"US\"\n ],\n \"devices\": [\n \"desktop\",\n \"mobile\"\n ],\n \"query_params\": [\n \"utm_source\"\n ],\n \"block_proxy\": true,\n \"enabled\": true\n },\n \"playback\": {\n \"disable_pause\": false,\n \"smart_pause\": true,\n \"scroll_to_action_in\": 30,\n \"action_after_finish\": {\n \"type\": \"loop\",\n \"start\": 5\n },\n \"enabled\": true\n },\n \"progress_bar\": {\n \"height\": 12,\n \"use_base_color\": false,\n \"color\": \"#0000FF\",\n \"enabled\": true\n },\n \"subtitle\": {\n \"control\": true,\n \"style\": {\n \"font_size\": \"16px\",\n \"color\": \"#FFFFFF\",\n \"background_color\": \"#000000\",\n \"text_align\": \"center\",\n \"show_by_default\": true\n },\n \"enabled\": true,\n \"track\": {\n \"file_id\": \"0190a0b0-2222-7222-8222-222222222222\"\n }\n },\n \"resume\": {\n \"disable_pause\": false,\n \"styles\": {\n \"background_color\": \"#1890FF\",\n \"foreground_color\": \"#FFFFFF\"\n },\n \"texts\": {\n \"play\": \"Keep watching\",\n \"replay\": \"Replay\",\n \"title\": \"You already started\"\n },\n \"enabled\": true\n },\n \"call_actions\": {\n \"enabled\": true,\n \"items\": [\n {\n \"base\": {\n \"type\": \"outside_video\",\n \"active\": true\n },\n \"window\": {\n \"start\": 5,\n \"end\": 30\n },\n \"action\": {\n \"content\": \"Buy now\",\n \"url\": \"https://example.com/checkout\",\n \"open_in_new_tab\": true\n },\n \"design\": {\n \"typography\": {\n \"family\": \"Inter\",\n \"letter_spacing\": 0,\n \"line_height\": 1.2,\n \"size\": 16,\n \"weight\": 600\n },\n \"styles\": {\n \"background_color\": \"#1890FF\",\n \"background_hover_color\": \"#096DD9\",\n \"text_color\": \"#FFFFFF\",\n \"text_hover_color\": \"#F0F0F0\",\n \"border_radius\": 8,\n \"shadow_enabled\": true,\n \"shadow\": {\n \"blur\": 12,\n \"color\": \"#00000040\",\n \"horizontal\": 0,\n \"vertical\": 4,\n \"spread\": 2\n },\n \"padding\": {\n \"binding\": true,\n \"values\": [\n 12,\n 24,\n 12,\n 24\n ]\n }\n }\n }\n }\n ]\n },\n \"smart_autoplay\": {\n \"enabled\": true,\n \"variants\": [\n {\n \"template_name\": \"discrete\",\n \"template_position\": \"top-left\"\n }\n ]\n },\n \"pixels\": {\n \"items\": [\n {\n \"base\": {\n \"name\": \"Fresh\",\n \"type\": \"custom\"\n },\n \"tag\": {\n \"html\": \"<div>tag</div>\"\n },\n \"dispatch\": {\n \"active\": true,\n \"threshold\": 50,\n \"mode\": \"percent\"\n }\n }\n ],\n \"enabled\": true\n },\n \"turbo\": {\n \"enabled\": true,\n \"speed\": 1.5\n },\n \"headline\": {\n \"variants\": [\n {\n \"id\": \"652f2b1e8f1b2c3d4e5f0201\",\n \"base\": {\n \"name\": \"Renamed\"\n }\n },\n {\n \"base\": {\n \"number\": 3\n },\n \"content\": {\n \"kind\": \"html\",\n \"html\": \"<h1>New</h1>\"\n }\n },\n {\n \"id\": \"652f2b1e8f1b2c3d4e5f0202\",\n \"_destroy\": true\n }\n ]\n },\n \"name\": \"Renamed\",\n \"description\": \"New copy\",\n \"folder_id\": \"652f2b1e8f1b2c3d4e5f00aa\",\n \"mini_hooks\": {\n \"elements\": [\n {\n \"id\": \"652f2b1e8f1b2c3d4e5f0016\",\n \"content\": {\n \"src_file_id\": \"0190a0b0-3333-7333-8333-333333333333\"\n }\n }\n ]\n },\n \"thumbsniper\": {\n \"images\": {\n \"start_file_id\": \"0190a0b0-1111-7111-8111-111111111111\",\n \"pause_file_id\": \"0190a0b0-1111-7111-8111-111111111111\",\n \"finish_file_id\": \"0190a0b0-1111-7111-8111-111111111111\"\n },\n \"cards\": [\n {\n \"base\": {\n \"image_file_id\": \"0190a0b0-1111-7111-8111-111111111111\"\n }\n }\n ]\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.vturb.com/v1/videos/{id}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Patch.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"controls\": {\n \"backward\": true,\n \"big_play\": false,\n \"forward\": true,\n \"fullscreen\": true,\n \"play_pause\": true,\n \"seekbar\": true,\n \"time\": true,\n \"volume\": true,\n \"fake_bar\": false,\n \"speed\": true\n },\n \"alternative_video\": {\n \"enabled\": true,\n \"id\": \"507f191e810c19729de860ea\"\n },\n \"immersive_mode\": {\n \"desktop\": true,\n \"disable_scrolling\": false,\n \"expand_on_play\": true,\n \"minimize_on_pause\": false,\n \"mobile\": true,\n \"enabled\": true\n },\n \"traffic_filter\": {\n \"fallback_video_id\": \"507f191e810c19729de860ea\",\n \"token\": \"gate_7f3c1a\",\n \"languages\": [\n \"pt\",\n \"en\"\n ],\n \"countries\": [\n \"BR\",\n \"US\"\n ],\n \"devices\": [\n \"desktop\",\n \"mobile\"\n ],\n \"query_params\": [\n \"utm_source\"\n ],\n \"block_proxy\": true,\n \"enabled\": true\n },\n \"playback\": {\n \"disable_pause\": false,\n \"smart_pause\": true,\n \"scroll_to_action_in\": 30,\n \"action_after_finish\": {\n \"type\": \"loop\",\n \"start\": 5\n },\n \"enabled\": true\n },\n \"progress_bar\": {\n \"height\": 12,\n \"use_base_color\": false,\n \"color\": \"#0000FF\",\n \"enabled\": true\n },\n \"subtitle\": {\n \"control\": true,\n \"style\": {\n \"font_size\": \"16px\",\n \"color\": \"#FFFFFF\",\n \"background_color\": \"#000000\",\n \"text_align\": \"center\",\n \"show_by_default\": true\n },\n \"enabled\": true,\n \"track\": {\n \"file_id\": \"0190a0b0-2222-7222-8222-222222222222\"\n }\n },\n \"resume\": {\n \"disable_pause\": false,\n \"styles\": {\n \"background_color\": \"#1890FF\",\n \"foreground_color\": \"#FFFFFF\"\n },\n \"texts\": {\n \"play\": \"Keep watching\",\n \"replay\": \"Replay\",\n \"title\": \"You already started\"\n },\n \"enabled\": true\n },\n \"call_actions\": {\n \"enabled\": true,\n \"items\": [\n {\n \"base\": {\n \"type\": \"outside_video\",\n \"active\": true\n },\n \"window\": {\n \"start\": 5,\n \"end\": 30\n },\n \"action\": {\n \"content\": \"Buy now\",\n \"url\": \"https://example.com/checkout\",\n \"open_in_new_tab\": true\n },\n \"design\": {\n \"typography\": {\n \"family\": \"Inter\",\n \"letter_spacing\": 0,\n \"line_height\": 1.2,\n \"size\": 16,\n \"weight\": 600\n },\n \"styles\": {\n \"background_color\": \"#1890FF\",\n \"background_hover_color\": \"#096DD9\",\n \"text_color\": \"#FFFFFF\",\n \"text_hover_color\": \"#F0F0F0\",\n \"border_radius\": 8,\n \"shadow_enabled\": true,\n \"shadow\": {\n \"blur\": 12,\n \"color\": \"#00000040\",\n \"horizontal\": 0,\n \"vertical\": 4,\n \"spread\": 2\n },\n \"padding\": {\n \"binding\": true,\n \"values\": [\n 12,\n 24,\n 12,\n 24\n ]\n }\n }\n }\n }\n ]\n },\n \"smart_autoplay\": {\n \"enabled\": true,\n \"variants\": [\n {\n \"template_name\": \"discrete\",\n \"template_position\": \"top-left\"\n }\n ]\n },\n \"pixels\": {\n \"items\": [\n {\n \"base\": {\n \"name\": \"Fresh\",\n \"type\": \"custom\"\n },\n \"tag\": {\n \"html\": \"<div>tag</div>\"\n },\n \"dispatch\": {\n \"active\": true,\n \"threshold\": 50,\n \"mode\": \"percent\"\n }\n }\n ],\n \"enabled\": true\n },\n \"turbo\": {\n \"enabled\": true,\n \"speed\": 1.5\n },\n \"headline\": {\n \"variants\": [\n {\n \"id\": \"652f2b1e8f1b2c3d4e5f0201\",\n \"base\": {\n \"name\": \"Renamed\"\n }\n },\n {\n \"base\": {\n \"number\": 3\n },\n \"content\": {\n \"kind\": \"html\",\n \"html\": \"<h1>New</h1>\"\n }\n },\n {\n \"id\": \"652f2b1e8f1b2c3d4e5f0202\",\n \"_destroy\": true\n }\n ]\n },\n \"name\": \"Renamed\",\n \"description\": \"New copy\",\n \"folder_id\": \"652f2b1e8f1b2c3d4e5f00aa\",\n \"mini_hooks\": {\n \"elements\": [\n {\n \"id\": \"652f2b1e8f1b2c3d4e5f0016\",\n \"content\": {\n \"src_file_id\": \"0190a0b0-3333-7333-8333-333333333333\"\n }\n }\n ]\n },\n \"thumbsniper\": {\n \"images\": {\n \"start_file_id\": \"0190a0b0-1111-7111-8111-111111111111\",\n \"pause_file_id\": \"0190a0b0-1111-7111-8111-111111111111\",\n \"finish_file_id\": \"0190a0b0-1111-7111-8111-111111111111\"\n },\n \"cards\": [\n {\n \"base\": {\n \"image_file_id\": \"0190a0b0-1111-7111-8111-111111111111\"\n }\n }\n ]\n }\n}"
response = http.request(request)
puts response.read_body{
"id": "652f2b1e8f1b2c3d4e5f6a7b",
"name": "Landing hero",
"description": null,
"folder_id": null,
"status": "processing",
"controls": {
"backward": null,
"big_play": null,
"forward": null,
"fullscreen": null,
"play_pause": null,
"seekbar": null,
"time": null,
"volume": null,
"fake_bar": null,
"speed": null
},
"call_actions": {
"enabled": false,
"items": []
},
"alternative_video": {
"enabled": null,
"id": null
},
"traffic_filter": {
"fallback_video_id": null,
"token": null,
"languages": null,
"countries": null,
"devices": null,
"query_params": null,
"block_proxy": null,
"enabled": null
},
"styles": {
"background_color": null,
"foreground_color": null,
"border_radius": null,
"linear_gradient": {
"angle": null,
"primary_color": null,
"primary_stop": null,
"secondary_color": null,
"secondary_stop": null,
"enabled": null
}
},
"general": {
"currency": null,
"pitch_time": null,
"preload_type": null,
"start_quality": null
},
"immersive_mode": {
"desktop": null,
"disable_scrolling": null,
"expand_on_play": null,
"minimize_on_pause": null,
"mobile": null,
"enabled": null
},
"mini_hooks": {
"elements": [],
"enabled": null
},
"pixels": {
"items": [],
"enabled": null
},
"playback": {
"disable_pause": null,
"scroll_to_action_in": null,
"smart_pause": null,
"action_after_finish": {
"type": null,
"start": null
},
"enabled": null
},
"subtitle": {
"control": null,
"track": {
"name": null,
"url": "https://static.vturb.com/assets/org_123/2026/08/12/0190a0b0-2222-7222-8222-222222222222/original.vtt"
},
"style": {
"font_size": null,
"color": null,
"background_color": null,
"text_align": null,
"bottom": null,
"max_width": null,
"show_by_default": null
},
"enabled": null
},
"thumbsniper": {
"background_color": null,
"images": {
"start": null,
"pause": null,
"finish": null
},
"cards": [],
"enabled": null
},
"turbo": {
"enabled": null,
"mode": "single",
"speed": null
},
"headline": {
"enabled": null,
"mode": "single",
"active_number": null,
"variants": []
},
"progress_bar": {
"height": null,
"use_base_color": null,
"current_color": null,
"color": null,
"enabled": null
},
"resume": {
"disable_pause": null,
"styles": {
"background_color": null,
"foreground_color": null
},
"texts": {
"play": null,
"replay": null,
"title": null
},
"enabled": null
},
"smart_autoplay": {
"enabled": null,
"mode": "single",
"active_number": null,
"variants": []
}
}{
"type": "https://docs.vturb.com/errors/bad_request",
"code": "bad_request",
"message": "The request includes fields this endpoint does not accept.",
"field": "unknown",
"request_id": "00000000-0000-0000-0000-000000000000"
}{
"type": "https://docs.vturb.com/errors/unauthorized",
"code": "unauthorized",
"message": "Missing or invalid API credential. Send a vt_ token in the Authorization header.",
"request_id": "00000000-0000-0000-0000-000000000000"
}{
"type": "https://docs.vturb.com/errors/forbidden",
"code": "forbidden",
"message": "The credential is missing the scope this action requires.",
"request_id": "00000000-0000-0000-0000-000000000000"
}{
"type": "https://docs.vturb.com/errors/not_found",
"code": "not_found",
"message": "Resource not found.",
"request_id": "00000000-0000-0000-0000-000000000000"
}{
"type": "https://docs.vturb.com/errors/unprocessable_content",
"code": "unprocessable_content",
"message": "The request is invalid. See errors for the fields that failed.",
"request_id": "00000000-0000-0000-0000-000000000000",
"errors": [
{
"field": "call_actions.items[0].window.start",
"message": "must be less than the end time"
},
{
"field": "call_actions.items[0].action.url",
"message": "must be present"
},
{
"field": "call_actions.items[0].action.content",
"message": "must be present"
},
{
"field": "call_actions.items[0].design.typography",
"message": "must be present"
},
{
"field": "call_actions.items[0].design.styles",
"message": "must be present"
}
]
}{
"type": "https://docs.vturb.com/errors/service_unavailable",
"code": "service_unavailable",
"message": "The service is temporarily unavailable. Retry shortly.",
"request_id": "00000000-0000-0000-0000-000000000000"
}