---
title: "Modify N images"
method: PATCH
path: "/imgs"
tags: ["Images"]
---

# Modify N images

`PATCH /imgs`

Partially update certain fields of existing images in the 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

- UpdateNImages[]
  - `id` string, required
  - `src` string, nullable — Url of the image in high or medium resolution (used as source for the AI).
  - `url_img_watermark` string, nullable — URL of the watermarked image.
  - `url_img_thumbnail` string, nullable — URL of the thumbnail image.
  - `title` string, nullable — A shorthand reference for the image.
  - `headline` string, nullable — Short text describing the image.
  - `caption` string, nullable — Long text describing the image.
  - `alt_text` string, nullable — Text describing the visual appearance of an image (Accessibility).
  - `ai_generated` boolean, nullable — Image generated by Artificial Intelligence.
  - `model_release` boolean, nullable — image with model release.
  - `property_release` boolean, nullable — image with property release.
  - `nsfw` boolean, nullable — Image Not Safe For Work.
  - `status` string, nullable — Current status of the image.
  - `date` string, nullable — Date of the image creation in year-month-day format. Capture date for photographies.
  - `location` string, nullable — A detailed description of the location, complementing the specified country and city with additional details such as street address or notable landmarks.
  - `city` string, nullable — Name of the country.
  - `country` string, nullable — Name of the country.
  - `event` string, nullable — Related event
  - `author` string, nullable — The name of the individual or entity responsible for creating the image, such as a photographer or painter.
  - `provider` string, nullable — The identifier of the provider, which can be either a unique numeric ID or a descriptive name.
  - `shot` string, nullable — Type of photography shot.
  - `scene` string, nullable — Spot, place, visual location
  - `technique` string, nullable — The specific method or process used in creating the artwork, reflecting the artist's unique approach or the traditional methods tied to certain mediums.
  - `medium` string, nullable — The material or substance used in the creation of the artwork or object. This field corresponds to various artistic mediums like oils, acrylics, or digital formats.
  - `keywords` string[], nullable — Specific tags describing the image
  - `categories` string[], nullable — General categories of the image
  - `collections` string[], nullable — Collections that the image belongs to

## Response `200`

images 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` — images 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)