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

# Replace 1 video

`PUT /vids/{video_id}`

Completely replace existing video in DB.

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

- Create1Video
  - `src` string, nullable
  - `thumbnail_url` string, nullable
  - `preview_url` string, nullable
  - `img_src` string, nullable
  - `img_zoom` string, nullable
  - `date` string, nullable
  - `location` string, nullable
  - `city` string, nullable
  - `country` string, nullable
  - `event` string, nullable
  - `author` string, nullable
  - `provider` string, nullable
  - `keywords` string[], nullable
  - `categories` string[], nullable
  - `collections` string[], nullable
  - `title` string, nullable
  - `headline` string, nullable
  - `description` string, nullable
  - `alt_text` string, nullable
  - `status` string, nullable
  - `medium` string, nullable
  - `ai_generated` boolean, nullable
  - `model_release` boolean, nullable
  - `property_release` boolean, nullable
  - `nsfw` boolean, nullable
  - `container` string, nullable
  - `codec_video` string, nullable
  - `codec_audio` string, nullable
  - `height` integer, nullable
  - `width` integer, nullable
  - `aspect_ratio` number, nullable
  - `fps` number, nullable
  - `duration_secs` number, nullable

## Response `200`

video successfully replaced

- 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 replacement 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)