---
title: "Modify 1 video"
method: PATCH
path: "/vids/{video_id}"
tags: ["Videos"]
---

# Modify 1 video

`PATCH /vids/{video_id}`

Partially update certain fields of an existing video by its ID.

## Query parameters

- `wait` boolean — Wait for completion?
- `urgent` boolean — Enqueue at head of queue if True
- `strict` boolean — Use strict mode if True
- `lang` string — en|es|pt|fr|ru

## Request body

- Update1Video
  - `src` string, nullable — URL del vídeo original.
  - `thumbnail_url` string, nullable — Nombre canónico backend para la miniatura del vídeo.
  - `preview_url` string, nullable — Nombre canónico backend para el preview reproducible del vídeo.
  - `img_src` string, nullable — Alias temporal de compatibilidad frontend para `thumbnail_url`.
  - `img_zoom` string, nullable — Alias temporal de compatibilidad frontend para `preview_url`.
  - `date` string, nullable — Fecha del vídeo en formato YYYY-MM-DD.
  - `location` string, nullable — Localización descriptiva del vídeo.
  - `city` string, nullable — Ciudad.
  - `country` string, nullable — País.
  - `event` string, nullable — Evento relacionado.
  - `author` string, nullable — Autor o creador.
  - `provider` string, nullable — Proveedor o agencia.
  - `keywords` string[], nullable — Palabras clave.
  - `categories` string[], nullable — Categorías.
  - `collections` string[], nullable — Colecciones.
  - `title` string, nullable — Título.
  - `headline` string, nullable — Titular.
  - `description` string, nullable — Descripción.
  - `alt_text` string, nullable — Texto alternativo.
  - `status` string, nullable — Estado editorial del vídeo.
  - `medium` string, nullable — Medio o tipo editorial.
  - `ai_generated` boolean, nullable — Indica si fue generado por IA.
  - `model_release` boolean, nullable — Indica si tiene model release.
  - `property_release` boolean, nullable — Indica si tiene property release.
  - `nsfw` boolean, nullable — Indica si está marcado como NSFW.
  - `container` string, nullable — Contenedor del vídeo, por ejemplo MP4.
  - `codec_video` string, nullable — Codec de vídeo, por ejemplo H264.
  - `codec_audio` string, nullable — Codec de audio, por ejemplo AAC.
  - `height` integer, nullable — Alto del vídeo.
  - `width` integer, nullable — Ancho del vídeo.
  - `aspect_ratio` number, nullable — Aspect ratio del vídeo.
  - `fps` number, nullable — Frames por segundo.
  - `duration_secs` number, nullable — Duración del vídeo en segundos.

## Response `200`

video successfully modified

- OperationOut — Output of: - a synchronous (blocking) operation. POST /imgs?wait=true - operation status. GET ops/<op_id>
  - `method` 'add' | 'upd' | 'del' | 'multiple', required — Tipo de respuesta asociada a una operación con imágenes.
  - `resource` 'video' | 'image' | 'celebs', required
  - `num_total` integer, required — Total of elements.
  - `num_good` integer, required — Number of correctly processed elements.
  - `num_bad` integer, required — Number of failed processed elements.
  - `is_started` boolean, required — Boolean indicating if the operation has started.
  - `is_finished` boolean, required — Boolean indicating if the operations has finished.
  - `all_good` boolean, nullable, required — Boolean indicating that there is no failed elements yet.
  - `do_wait` boolean, required — Boolean for know if have to wait or not.
  - `do_urgent` boolean, required — Boolean for know if it is an urgent operation.
  - `do_strict` boolean, required — Boolean for know if is required strict operations over DB.
  - `idle_ms` number, required — Duration (milliseconds) between the operation has been created and has started.
  - `exec_ms` number, required — Duration (milliseconds) between the operation has been started and has finished.
  - `created_at` string, required — Creation datetime.
  - `started_at` string, required — Start datetime.
  - `finished_at` string, required — Finalization datetime.
  - `errors` OpError[], required — List of errors that occurred during processing the operation.
    - `id` integer, required — Identifier of the resource that triggered the error.
    - `msg` string, required — Human-readable description of the error returned by the system.

## Other responses

- `202` — video modification accepted
- `422` — Validation Error

---

[API](https://skmtc.net/wesog/apis/wesog-api.md) · [All operations](https://skmtc.net/wesog/apis/wesog-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/wesog/wesog-api/versions/97381dd1ff4c/schema)