---
title: "Changes to Image Search"
method: POST
path: "/v1/image-search"
---

# Changes to Image Search

`POST /v1/image-search`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 17 of 56 revisions.

- **2026-10-23** `7aededb0a617`: 1 info
- **2026-10-20** `f642382eaf91`: 3 info
- **2026-10-19** `7d1e0ccffc95`: 2 info
- **2026-10-16** `93329818bdf4`: 3 breaking, 3 warning, 14 info
- **2026-07-29** `1200b0ff4724`: 1 info
- **2026-07-29** `e235d378571b`: 1 info
- **2026-07-23** `c0bf28048dc1`: 1 info
- **2026-07-09** `5e0c73f4bbb1`: 2 warning, 2 info
- **2026-07-09** `cd7de4a95828`: 4 info
- **2026-07-01** `eadea2dff97e`: 1 info
- **2026-06-27** `a5ad3b32ded8`: 2 info
- **2026-06-19** `1adfb8c09586`: 1 info
- **2026-05-25** `b7448351fec3`: 1 info
- **2026-05-25** `73e61fa88fbc`: 3 info
- **2026-05-21** `809753716108`: 1 info
- **2026-05-21** `48ea59b2e819`: 1 breaking, 14 info
- **2026-04-29** `6d3d82903abb`: 1 info

## Changes

- **2026-10-23** `7aededb0a617`: 1 info
  - added the new optional request property `config/offer_refresh_timeout_ms`
- **2026-10-20** `f642382eaf91`: 3 info
  - added the new `PL` enum value to the request property `config/country/anyOf[subschema #1: CountryCode]/`
  - added the new `PLN` enum value to the request property `config/currency/anyOf[subschema #1: CurrencyCode]/`
  - added the new `pl` enum value to the request property `config/language/anyOf[subschema #1: LanguageCode]/`
- **2026-10-19** `7d1e0ccffc95`: 2 info
  - added the new `CH` enum value to the request property `config/country/anyOf[subschema #1: CountryCode]/`
  - added the new `CHF` enum value to the request property `config/currency/anyOf[subschema #1: CurrencyCode]/`
- **2026-10-16** `93329818bdf4`: 3 breaking, 3 warning, 14 info
  - removed `subschema #1` from the `filters/sale` request property `anyOf` list
  - request property `filters/availability` list-of-types was narrowed by removing types `null` from media type `application/json`
  - the `filters/availability` request property's minItems was increased to `1`
  - removed the request property `filters/condition`
  - removed the optional property `products/items/categories` from the response with the `200` status
  - removed the optional property `products/items/images/items/is_cleaned_image` from the response with the `200` status
  - added the new optional `header` request parameter `x-user-id`
  - added the new optional request property `config/collection_id`
  - added the new optional request property `filters/conditions`
  - added `#/components/schemas/Sale` to the `filters/sale` request property `anyOf` list
  - the `filters` request property default value changed from `{}` to `{"conditions":["new"],"availability":["InStock"]}`
  - the `config` request property default value `{}` was removed
  - added the optional property `products/items/colors` to the response with the `200` status
  - added the optional property `products/items/ratings` to the response with the `200` status
  - added `#/components/schemas/Condition` to the `products/items/offers/items/condition` response property `anyOf` list for the response status `200`
  - added `#/components/schemas/Gender` to the `products/items/gender` response property `anyOf` list for the response status `200`
  - added `#/components/schemas/OfferAvailabilityStatus` to the `products/items/variants/anyOf[subschema #1: Variants]/options/items/values/items/available` response property `anyOf` list for the response status `200`
  - removed `#/components/schemas/AvailabilityStatus` from the `products/items/variants/anyOf[subschema #1: Variants]/options/items/values/items/available` response property `anyOf` list for the response status `200`
  - removed `subschema #1` from the `products/items/gender` response property `anyOf` list for the response status `200`
  - removed `subschema #1` from the `products/items/offers/items/condition` response property `anyOf` list for the response status `200`
- **2026-07-29** `1200b0ff4724`: 1 info
  - response property `products/items/images/items/is_cleaned_image` deprecated
- **2026-07-29** `e235d378571b`: 1 info
  - added the optional property `products/items/images/items/cleaned_url` to the response with the `200` status
- **2026-07-23** `c0bf28048dc1`: 1 info
  - added the new optional request property `filters/colors/anyOf[subschema #1: SearchColorsFilter]/match`
- **2026-07-09** `5e0c73f4bbb1`: 2 warning, 2 info
  - removed the request property `config/preferred_length_unit`
  - removed the request property `config/preferred_weight_unit`
  - added the new optional request property `config/length_unit`
  - added the new optional request property `config/weight_unit`
- **2026-07-09** `cd7de4a95828`: 4 info
  - added the new optional request property `config/preferred_length_unit`
  - added the new optional request property `config/preferred_weight_unit`
  - added the new optional request property `filters/dimensions`
  - added the optional property `products/items/offers/items/dimensions` to the response with the `200` status
- **2026-07-01** `eadea2dff97e`: 1 info
  - added the non-success response with the status `504`
- **2026-06-27** `a5ad3b32ded8`: 2 info
  - added the new optional request property `filters/sale`
  - added the new optional request property `segment`
- **2026-06-19** `1adfb8c09586`: 1 info
  - added the optional property `products/items/offers/items/condition` to the response with the `200` status
- **2026-05-25** `b7448351fec3`: 1 info
  - added the optional property `products/items/images/items/is_cleaned_image` to the response with the `200` status
- **2026-05-25** `73e61fa88fbc`: 3 info
  - added the optional property `products/items/category` to the response with the `200` status
  - the `categories` response's property default value `` was removed for the status `200`
  - response property `products/items/categories` deprecated
- **2026-05-21** `809753716108`: 1 info
  - added the optional property `products/items/variants` to the response with the `200` status
- **2026-05-21** `48ea59b2e819`: 1 breaking, 14 info
  - removed the enum value `unisex` of the request property `filters/gender/anyOf[subschema #1]/`
  - added the new optional request property `filters/attributes`
  - added the new optional request property `filters/colors`
  - added the new `GR` enum value to the request property `config/country/anyOf[subschema #1]/`
  - added the new `RO` enum value to the request property `config/country/anyOf[subschema #1]/`
  - added the new `RON` enum value to the request property `config/currency/anyOf[subschema #1]/`
  - added the new `el` enum value to the request property `config/language/anyOf[subschema #1]/`
  - added the new `ro` enum value to the request property `config/language/anyOf[subschema #1]/`
  - added the optional property `products/items/age` to the response with the `200` status
  - added the optional property `products/items/structured_attributes` to the response with the `200` status
  - added `subschema #1, subschema #2` to the `detail` response property `anyOf` list for the response status `400`
  - added `subschema #1, subschema #2` to the `detail` response property `anyOf` list for the response status `401`
  - added `subschema #1, subschema #2` to the `detail` response property `anyOf` list for the response status `402`
  - added `subschema #1, subschema #2` to the `detail` response property `anyOf` list for the response status `422`
  - added `subschema #1, subschema #2` to the `detail` response property `anyOf` list for the response status `500`
- **2026-04-29** `6d3d82903abb`: 1 info
  - endpoint added

---

[Operation](https://skmtc.dev/channel3-ai/apis/channel3-typescript-api/docs/v1/image-search/post.md) - [API](https://skmtc.dev/channel3-ai/apis/channel3-typescript-api.md) - [Page](https://skmtc.dev/channel3-ai/apis/channel3-typescript-api/changes/v1/image-search/post)
