Actualizar un vídeo

El cuerpo de la solicitud se agrupa por funcionalidad del reproductor: controls, playback, turbo, smart_autoplay, pixels y más. Es un merge-patch: envía solo los grupos que quieres cambiar y, dentro de cada grupo, solo las claves que modificas; todo lo demás conserva su valor guardado.

Authorization

bearerAuth

AuthorizationBearer <token>

Pega tu token de la API de VTurb (vt_...). Se envía como Authorization: Bearer <token>.

In: header

Path Parameters

id*string

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

controls?

Interruptores de la interfaz del reproductor — cada clave muestra u oculta un control en pantalla. Consulta la guía Actualizar controles para ver un ejemplo específico.

alternative_video?

Vídeo de respaldo para los espectadores que no pueden reproducir el principal. Consulta la guía Actualizar vídeo alternativo.

immersive_mode?

La toma de pantalla completa — dónde se ejecuta y cuándo se expande. Consulta la guía Actualizar modo inmersivo.

traffic_filter?

Desvía el tráfico no deseado — país equivocado, dispositivo equivocado, proxies — a un vídeo de respaldo. Consulta la guía Actualizar filtro de tráfico.

playback?

Comportamiento de pausa, el momento de desplazamiento hasta la acción y lo que pasa cuando el vídeo termina. Consulta la guía Actualizar reproducción.

progress_bar?

La barra de progreso señuelo — altura, color y si toma prestada la paleta del reproductor. Consulta la guía Actualizar barra de progreso.

subtitle?

Activación y estilo de los subtítulos; el archivo de la pista en sí es de solo lectura. Consulta la guía Actualizar subtítulo.

resume?

El aviso de seguir viendo que ven los espectadores que regresan — su texto y sus colores. Consulta la guía Actualizar reanudación.

call_actions?

Colección de CTA — un elemento con id modifica ese CTA, sin él lo crea, con _destroy: true lo elimina. Consulta la guía Actualizar llamadas a la acción.

smart_autoplay?

Superposición de reproducción automática sin sonido — elige una plantilla y una posición en la cuadrícula. Consulta la guía Actualizar smart autoplay.

headline?

Las variantes de titular que se dibujan encima del reproductor — misma semántica de colección id/_destroy que los CTA. Configura al menos dos y luego inicia la prueba A/B desde el endpoint de experimentos.

name?string

description?string

folder_id?string

pixels?

Píxeles de seguimiento y en qué momento de la reproducción se disparan — misma semántica de colección id/_destroy que los CTA. Consulta la guía Actualizar píxeles.

turbo?

Reproducción acelerada — el interruptor y su velocidad; los campos hoja del experimento son de solo lectura. Consulta la guía Actualizar turbo.

mini_hooks?

thumbsniper?

Response Body

`application/json`

`application/problem+json`

curl -X PATCH "https://example.com/v1/videos/652f2b1e8f1b2c3d4e5f6a7b" \  -H "Content-Type: application/json" \  -d '{    "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": {      "enabled": true,      "desktop": true,      "disable_scrolling": false,      "expand_on_play": true,      "minimize_on_pause": false,      "mobile": true    },    "traffic_filter": {      "enabled": true,      "fallback_video_id": "507f191e810c19729de860ea",      "token": "gate_7f3c1a",      "languages": [        "pt",        "en"      ],      "countries": [        "BR",        "US"      ],      "devices": [        "desktop",        "mobile"      ],      "query_params": [        "utm_source"      ],      "block_proxy": true    },    "playback": {      "enabled": true,      "disable_pause": false,      "smart_pause": true,      "scroll_to_action_in": 30,      "action_after_finish": {        "type": "loop",        "start": 5      }    },    "progress_bar": {      "enabled": true,      "height": 12,      "use_base_color": false,      "color": "#0000FF"    },    "subtitle": {      "enabled": true,      "control": true,      "style": {        "font_size": "16px",        "color": "#FFFFFF",        "background_color": "#000000",        "text_align": "center",        "show_by_default": true      },      "track": {        "file_id": "0190a0b0-2222-7222-8222-222222222222"      }    },    "resume": {      "enabled": true,      "disable_pause": false,      "styles": {        "background_color": "#1890FF",        "foreground_color": "#FFFFFF"      },      "texts": {        "play": "Keep watching",        "replay": "Replay",        "title": "You already started"      }    },    "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": "image",          "template_position": "top-right",          "file_id": "0190a0b0-0000-7000-8000-0000000000f1",          "scale": 0.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",    "pixels": {      "enabled": true,      "items": [        {          "base": {            "name": "Fresh",            "type": "custom"          },          "tag": {            "html": "<div>tag</div>"          },          "dispatch": {            "active": true,            "threshold": 50,            "mode": "percent"          }        }      ]    },    "turbo": {      "enabled": true,      "speed": 1.5    },    "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"          }        }      ]    }  }'

{  "description": null,  "folder_id": null,  "id": "652f2b1e8f1b2c3d4e5f6a7b",  "status": "processing",  "name": "Landing hero",  "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": {    "enabled": null,    "fallback_video_id": null,    "token": null,    "languages": null,    "countries": null,    "devices": null,    "query_params": null,    "block_proxy": null  },  "styles": {    "background_color": null,    "foreground_color": null,    "border_radius": null,    "linear_gradient": {      "enabled": null,      "angle": null,      "primary_color": null,      "primary_stop": null,      "secondary_color": null,      "secondary_stop": null    }  },  "general": {    "currency": null,    "pitch_time": null,    "preload_type": null,    "start_quality": null  },  "immersive_mode": {    "enabled": null,    "desktop": null,    "disable_scrolling": null,    "expand_on_play": null,    "minimize_on_pause": null,    "mobile": null  },  "mini_hooks": {    "enabled": null,    "elements": []  },  "pixels": {    "enabled": null,    "items": []  },  "playback": {    "enabled": null,    "disable_pause": null,    "scroll_to_action_in": null,    "smart_pause": null,    "action_after_finish": {      "type": null,      "start": null    }  },  "subtitle": {    "enabled": null,    "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    }  },  "thumbsniper": {    "enabled": null,    "background_color": null,    "images": {      "start": null,      "pause": null,      "finish": null    },    "cards": []  },  "turbo": {    "enabled": null,    "mode": "single",    "speed": null  },  "headline": {    "enabled": null,    "mode": "single",    "active_number": null,    "variants": []  },  "progress_bar": {    "enabled": null,    "height": null,    "use_base_color": null,    "current_color": null,    "color": null  },  "resume": {    "enabled": null,    "disable_pause": null,    "styles": {      "background_color": null,      "foreground_color": null    },    "texts": {      "play": null,      "replay": null,      "title": null    }  },  "smart_autoplay": {    "enabled": null,    "active_number": null,    "mode": "single",    "variants": []  }}

Actualizar un vídeo

Authorization

Path Parameters

Request Body

Response Body

200application/json

400application/problem+json

401application/problem+json

403application/problem+json

404application/problem+json

422application/problem+json

503application/problem+json

`application/json`

`application/problem+json`

`application/problem+json`

`application/problem+json`

`application/problem+json`

`application/problem+json`

`application/problem+json`