---
title: "Changes to Operate on item batch"
method: POST
path: "/catalogs/items/batch"
---

# Changes to Operate on item batch

`POST /catalogs/items/batch`

> Every recorded change to this endpoint, newest first.

## Timeline

Changed in 20 of 29 revisions.

- **2026-06-04** (v5) `b698c180678a` — 35 breaking, 48 warning, 240 info
- **2025-12-11** (v5) `79f62f71f05b` — 1 breaking, 86 info
- **2025-10-16** (v5) `14c297539b64` — 26 info
- **2025-08-14** (v5) `7d64d863909a` — 4 info
- **2025-08-12** (v5) `8fb7ab040159` — 7 info
- **2025-07-16** (v5) `43134ca41f18` — 30 warning, 406 info
- **2025-04-04** (v5) `10f9eba4ad97` — 4 breaking, 42 info
- **2024-08-14** (v5) `89c27ed39cfd` — 514 breaking, 13 info
- **2024-04-23** (v5) `f9321315766f` — 7 breaking, 5 warning, 9 info
- **2024-02-08** (v5) `7529b464d5cb` — 1 warning, 13 info
- **2023-08-17** (v5) `0ff12596bafd` — 3 breaking, 5 warning, 4 info
- **2023-07-14** (v5) `52586a274771` — 5 info
- **2023-05-12** (v5) `689b4b267639` — 1 info
- **2023-02-14** (v5) `be19b77aa78a` — 3 info
- **2022-11-14** (v5) `e041d7b0cef0` — 2 info
- **2022-09-07** (v5) `bd20b6eb152f` — 4 warning, 2 info
- **2022-07-11** (v5) `0d5998752011` — 1 breaking, 43 info
- **2022-04-12** (v5) `723c51158044` — 4 breaking, 67 info
- **2022-04-08** (v5) `33ec8e7421c7` — 64 breaking, 6 warning
- **2022-04-08** (v5) `c561dee8c137` — 1 info

## Changes

- **2026-06-04** (v5) `b698c180678a` — 35 breaking, 48 warning, 240 info
  - added `#/components/schemas/Pinterest.Lib.IntegerFormatType` to the `oneOf[subschema #1: operate on item batch]/oneOf[#/components/schemas/CatalogsCreativeAssetsBatchRequest]/catalog_id` request property `allOf` list
  - added `#/components/schemas/Pinterest.Lib.IntegerFormatType` to the `oneOf[subschema #1: operate on item batch]/oneOf[#/components/schemas/CatalogsHotelBatchRequest]/catalog_id` request property `allOf` list
  - added `#/components/schemas/Pinterest.Lib.IntegerFormatType` to the `oneOf[subschema #1: operate on item batch]/oneOf[#/components/schemas/CatalogsRetailBatchRequest]/catalog_id` request property `allOf` list
  - removed `#/components/schemas/CatalogsCreateCreativeAssetsItem, #/components/schemas/CatalogsUpsertCreativeAssetsItem, #/components/schemas/CatalogsUpdateCreativeAssetsItem, #/components/schemas/CatalogsDeleteCreativeAssetsItem` from the `oneOf[subschema #1: operate on item batch]/oneOf[#/components/schemas/CatalogsCreativeAssetsBatchRequest]/items/items/` request property `anyOf` list
  - removed `#/components/schemas/CatalogsCreateHotelItem, #/components/schemas/CatalogsUpsertHotelItem, #/components/schemas/CatalogsUpdateHotelItem, #/components/schemas/CatalogsDeleteHotelItem` from the `oneOf[subschema #1: operate on item batch]/oneOf[#/components/schemas/CatalogsHotelBatchRequest]/items/items/` request property `anyOf` list
  - removed `#/components/schemas/CatalogsCreateRetailItem, #/components/schemas/CatalogsUpdateRetailItem, #/components/schemas/CatalogsUpsertRetailItem, #/components/schemas/CatalogsDeleteRetailItem` from the `oneOf[subschema #1: operate on item batch]/oneOf[#/components/schemas/CatalogsRetailBatchRequest]/items/items/` request property `anyOf` list
  - removed the enum value `CREATE` of the request property `oneOf[subschema #2: legacy_retail_only]/oneOf[#/components/schemas/CatalogsItemsDeleteBatchRequest]/operation`
  - removed the enum value `CREATE` of the request property `oneOf[subschema #2: legacy_retail_only]/oneOf[#/components/schemas/CatalogsItemsDeleteDiscontinuedBatchRequest]/operation`
  - removed the enum value `CREATE` of the request property `oneOf[subschema #2: legacy_retail_only]/oneOf[#/components/schemas/CatalogsItemsUpdateBatchRequest]/operation`
  - removed the enum value `CREATE` of the request property `oneOf[subschema #2: legacy_retail_only]/oneOf[#/components/schemas/CatalogsItemsUpsertBatchRequest]/operation`
  - removed the enum value `DELETE` of the request property `oneOf[subschema #2: legacy_retail_only]/oneOf[#/components/schemas/CatalogsItemsCreateBatchRequest]/operation`
  - removed the enum value `DELETE` of the request property `oneOf[subschema #2: legacy_retail_only]/oneOf[#/components/schemas/CatalogsItemsDeleteDiscontinuedBatchRequest]/operation`
  - removed the enum value `DELETE` of the request property `oneOf[subschema #2: legacy_retail_only]/oneOf[#/components/schemas/CatalogsItemsUpdateBatchRequest]/operation`
  - removed the enum value `DELETE` of the request property `oneOf[subschema #2: legacy_retail_only]/oneOf[#/components/schemas/CatalogsItemsUpsertBatchRequest]/operation`
  - removed the enum value `DELETE_DISCONTINUED` of the request property `oneOf[subschema #2: legacy_retail_only]/oneOf[#/components/schemas/CatalogsItemsCreateBatchRequest]/operation`
  - removed the enum value `DELETE_DISCONTINUED` of the request property `oneOf[subschema #2: legacy_retail_only]/oneOf[#/components/schemas/CatalogsItemsDeleteBatchRequest]/operation`
  - removed the enum value `DELETE_DISCONTINUED` of the request property `oneOf[subschema #2: legacy_retail_only]/oneOf[#/components/schemas/CatalogsItemsUpdateBatchRequest]/operation`
  - removed the enum value `DELETE_DISCONTINUED` of the request property `oneOf[subschema #2: legacy_retail_only]/oneOf[#/components/schemas/CatalogsItemsUpsertBatchRequest]/operation`
  - removed the enum value `UPDATE` of the request property `oneOf[subschema #2: legacy_retail_only]/oneOf[#/components/schemas/CatalogsItemsCreateBatchRequest]/operation`
  - removed the enum value `UPDATE` of the request property `oneOf[subschema #2: legacy_retail_only]/oneOf[#/components/schemas/CatalogsItemsDeleteBatchRequest]/operation`
  - removed the enum value `UPDATE` of the request property `oneOf[subschema #2: legacy_retail_only]/oneOf[#/components/schemas/CatalogsItemsDeleteDiscontinuedBatchRequest]/operation`
  - removed the enum value `UPDATE` of the request property `oneOf[subschema #2: legacy_retail_only]/oneOf[#/components/schemas/CatalogsItemsUpsertBatchRequest]/operation`
  - removed the enum value `UPSERT` of the request property `oneOf[subschema #2: legacy_retail_only]/oneOf[#/components/schemas/CatalogsItemsCreateBatchRequest]/operation`
  - removed the enum value `UPSERT` of the request property `oneOf[subschema #2: legacy_retail_only]/oneOf[#/components/schemas/CatalogsItemsDeleteBatchRequest]/operation`
  - removed the enum value `UPSERT` of the request property `oneOf[subschema #2: legacy_retail_only]/oneOf[#/components/schemas/CatalogsItemsDeleteDiscontinuedBatchRequest]/operation`
  - removed the enum value `UPSERT` of the request property `oneOf[subschema #2: legacy_retail_only]/oneOf[#/components/schemas/CatalogsItemsUpdateBatchRequest]/operation`
  - removed `subschema #2` from the `oneOf[subschema #2: legacy_retail_only]/oneOf[#/components/schemas/CatalogsItemsUpdateBatchRequest]/items/items/attributes/gtin` request property `oneOf` list
  - the `oneOf[subschema #1: operate on item batch]/oneOf[#/components/schemas/CatalogsCreativeAssetsBatchRequest]/catalog_id` request property type/format changed from `string`/`` to ``/``
  - the `oneOf[subschema #1: operate on item batch]/oneOf[#/components/schemas/CatalogsHotelBatchRequest]/catalog_id` request property type/format changed from `string`/`` to ``/``
  - the `oneOf[subschema #1: operate on item batch]/oneOf[#/components/schemas/CatalogsRetailBatchRequest]/catalog_id` request property type/format changed from `string`/`` to ``/``
  - the `oneOf[subschema #1: operate on item batch]/oneOf[#/components/schemas/CatalogsRetailBatchRequest]/items/items/` request property type/format changed from ``/`` to `object`/``
  - the `oneOf[#/components/schemas/CatalogsCreativeAssetsItemsBatch]/batch_id` response's property type/format changed from `string`/`` to ``/`` for status `200`
  - the `oneOf[#/components/schemas/CatalogsHotelItemsBatch]/batch_id` response's property type/format changed from `string`/`` to ``/`` for status `200`
  - the `oneOf[#/components/schemas/CatalogsRetailItemsBatch]/batch_id` response's property type/format changed from `string`/`` to ``/`` for status `200`
  - removed the required property `catalog_type` from the response with the `200` status
  - removed `#/components/schemas/UpdatableItemAttributes, subschema #1, subschema #3` from the `oneOf[subschema #2: legacy_retail_only]/oneOf[#/components/schemas/CatalogsItemsCreateBatchRequest]/items/items/attributes` request property `allOf` list
  - removed `#/components/schemas/UpdatableItemAttributes, subschema #1, subschema #3` from the `oneOf[subschema #2: legacy_retail_only]/oneOf[#/components/schemas/CatalogsItemsUpsertBatchRequest]/items/items/attributes` request property `allOf` list
  - the `oneOf[subschema #2: legacy_retail_only]/oneOf[#/components/schemas/CatalogsItemsUpdateBatchRequest]/items/items/attributes/ad_image_0_link` request property's maxLength was set to `2000`
  - the `oneOf[subschema #2: legacy_retail_only]/oneOf[#/components/schemas/CatalogsItemsUpdateBatchRequest]/items/items/attributes/ad_image_0_tag` request property's maxLength was set to `511`
  - the `oneOf[subschema #2: legacy_retail_only]/oneOf[#/components/schemas/CatalogsItemsUpdateBatchRequest]/items/items/attributes/ad_image_10_link` request property's maxLength was set to `2000`
  - …283 more
- **2025-12-11** (v5) `79f62f71f05b` — 1 breaking, 86 info
  - the response property `oneOf[#/components/schemas/CatalogsRetailItemsBatch]/created_time` became nullable for the status `200`
  - added the new optional request property `oneOf[subschema #1: operate on item batch]/oneOf[#/components/schemas/CatalogsRetailBatchRequest]/items/items/anyOf[#/components/schemas/CatalogsCreateRetailItem]/attributes/allOf[#/components/schemas/UpdatableItemAttributes]/ad_video_0_link`
  - added the new optional request property `oneOf[subschema #1: operate on item batch]/oneOf[#/components/schemas/CatalogsRetailBatchRequest]/items/items/anyOf[#/components/schemas/CatalogsCreateRetailItem]/attributes/allOf[#/components/schemas/UpdatableItemAttributes]/ad_video_0_tag`
  - added the new optional request property `oneOf[subschema #1: operate on item batch]/oneOf[#/components/schemas/CatalogsRetailBatchRequest]/items/items/anyOf[#/components/schemas/CatalogsCreateRetailItem]/attributes/allOf[#/components/schemas/UpdatableItemAttributes]/ad_video_1_link`
  - added the new optional request property `oneOf[subschema #1: operate on item batch]/oneOf[#/components/schemas/CatalogsRetailBatchRequest]/items/items/anyOf[#/components/schemas/CatalogsCreateRetailItem]/attributes/allOf[#/components/schemas/UpdatableItemAttributes]/ad_video_1_tag`
  - added the new optional request property `oneOf[subschema #1: operate on item batch]/oneOf[#/components/schemas/CatalogsRetailBatchRequest]/items/items/anyOf[#/components/schemas/CatalogsCreateRetailItem]/attributes/allOf[#/components/schemas/UpdatableItemAttributes]/ad_video_2_link`
  - added the new optional request property `oneOf[subschema #1: operate on item batch]/oneOf[#/components/schemas/CatalogsRetailBatchRequest]/items/items/anyOf[#/components/schemas/CatalogsCreateRetailItem]/attributes/allOf[#/components/schemas/UpdatableItemAttributes]/ad_video_2_tag`
  - added the new optional request property `oneOf[subschema #1: operate on item batch]/oneOf[#/components/schemas/CatalogsRetailBatchRequest]/items/items/anyOf[#/components/schemas/CatalogsCreateRetailItem]/attributes/allOf[#/components/schemas/UpdatableItemAttributes]/android_deep_link`
  - added the new optional request property `oneOf[subschema #1: operate on item batch]/oneOf[#/components/schemas/CatalogsRetailBatchRequest]/items/items/anyOf[#/components/schemas/CatalogsCreateRetailItem]/attributes/allOf[#/components/schemas/UpdatableItemAttributes]/ios_deep_link`
  - added the new optional request property `oneOf[subschema #1: operate on item batch]/oneOf[#/components/schemas/CatalogsRetailBatchRequest]/items/items/anyOf[#/components/schemas/CatalogsCreateRetailItem]/attributes/allOf[subschema #3]/ad_video_0_link`
  - added the new optional request property `oneOf[subschema #1: operate on item batch]/oneOf[#/components/schemas/CatalogsRetailBatchRequest]/items/items/anyOf[#/components/schemas/CatalogsCreateRetailItem]/attributes/allOf[subschema #3]/ad_video_0_tag`
  - added the new optional request property `oneOf[subschema #1: operate on item batch]/oneOf[#/components/schemas/CatalogsRetailBatchRequest]/items/items/anyOf[#/components/schemas/CatalogsCreateRetailItem]/attributes/allOf[subschema #3]/ad_video_1_link`
  - added the new optional request property `oneOf[subschema #1: operate on item batch]/oneOf[#/components/schemas/CatalogsRetailBatchRequest]/items/items/anyOf[#/components/schemas/CatalogsCreateRetailItem]/attributes/allOf[subschema #3]/ad_video_1_tag`
  - added the new optional request property `oneOf[subschema #1: operate on item batch]/oneOf[#/components/schemas/CatalogsRetailBatchRequest]/items/items/anyOf[#/components/schemas/CatalogsCreateRetailItem]/attributes/allOf[subschema #3]/ad_video_2_link`
  - added the new optional request property `oneOf[subschema #1: operate on item batch]/oneOf[#/components/schemas/CatalogsRetailBatchRequest]/items/items/anyOf[#/components/schemas/CatalogsCreateRetailItem]/attributes/allOf[subschema #3]/ad_video_2_tag`
  - added the new optional request property `oneOf[subschema #1: operate on item batch]/oneOf[#/components/schemas/CatalogsRetailBatchRequest]/items/items/anyOf[#/components/schemas/CatalogsDeleteRetailItem]/last_updated_time`
  - added the new optional request property `oneOf[subschema #1: operate on item batch]/oneOf[#/components/schemas/CatalogsRetailBatchRequest]/items/items/anyOf[#/components/schemas/CatalogsUpdateRetailItem]/attributes/ad_video_0_link`
  - added the new optional request property `oneOf[subschema #1: operate on item batch]/oneOf[#/components/schemas/CatalogsRetailBatchRequest]/items/items/anyOf[#/components/schemas/CatalogsUpdateRetailItem]/attributes/ad_video_0_tag`
  - added the new optional request property `oneOf[subschema #1: operate on item batch]/oneOf[#/components/schemas/CatalogsRetailBatchRequest]/items/items/anyOf[#/components/schemas/CatalogsUpdateRetailItem]/attributes/ad_video_1_link`
  - added the new optional request property `oneOf[subschema #1: operate on item batch]/oneOf[#/components/schemas/CatalogsRetailBatchRequest]/items/items/anyOf[#/components/schemas/CatalogsUpdateRetailItem]/attributes/ad_video_1_tag`
  - added the new optional request property `oneOf[subschema #1: operate on item batch]/oneOf[#/components/schemas/CatalogsRetailBatchRequest]/items/items/anyOf[#/components/schemas/CatalogsUpdateRetailItem]/attributes/ad_video_2_link`
  - added the new optional request property `oneOf[subschema #1: operate on item batch]/oneOf[#/components/schemas/CatalogsRetailBatchRequest]/items/items/anyOf[#/components/schemas/CatalogsUpdateRetailItem]/attributes/ad_video_2_tag`
  - added the new optional request property `oneOf[subschema #1: operate on item batch]/oneOf[#/components/schemas/CatalogsRetailBatchRequest]/items/items/anyOf[#/components/schemas/CatalogsUpdateRetailItem]/attributes/android_deep_link`
  - added the new optional request property `oneOf[subschema #1: operate on item batch]/oneOf[#/components/schemas/CatalogsRetailBatchRequest]/items/items/anyOf[#/components/schemas/CatalogsUpdateRetailItem]/attributes/ios_deep_link`
  - added the new optional request property `oneOf[subschema #1: operate on item batch]/oneOf[#/components/schemas/CatalogsRetailBatchRequest]/items/items/anyOf[#/components/schemas/CatalogsUpsertRetailItem]/attributes/allOf[#/components/schemas/UpdatableItemAttributes]/ad_video_0_link`
  - added the new optional request property `oneOf[subschema #1: operate on item batch]/oneOf[#/components/schemas/CatalogsRetailBatchRequest]/items/items/anyOf[#/components/schemas/CatalogsUpsertRetailItem]/attributes/allOf[#/components/schemas/UpdatableItemAttributes]/ad_video_0_tag`
  - added the new optional request property `oneOf[subschema #1: operate on item batch]/oneOf[#/components/schemas/CatalogsRetailBatchRequest]/items/items/anyOf[#/components/schemas/CatalogsUpsertRetailItem]/attributes/allOf[#/components/schemas/UpdatableItemAttributes]/ad_video_1_link`
  - added the new optional request property `oneOf[subschema #1: operate on item batch]/oneOf[#/components/schemas/CatalogsRetailBatchRequest]/items/items/anyOf[#/components/schemas/CatalogsUpsertRetailItem]/attributes/allOf[#/components/schemas/UpdatableItemAttributes]/ad_video_1_tag`
  - added the new optional request property `oneOf[subschema #1: operate on item batch]/oneOf[#/components/schemas/CatalogsRetailBatchRequest]/items/items/anyOf[#/components/schemas/CatalogsUpsertRetailItem]/attributes/allOf[#/components/schemas/UpdatableItemAttributes]/ad_video_2_link`
  - added the new optional request property `oneOf[subschema #1: operate on item batch]/oneOf[#/components/schemas/CatalogsRetailBatchRequest]/items/items/anyOf[#/components/schemas/CatalogsUpsertRetailItem]/attributes/allOf[#/components/schemas/UpdatableItemAttributes]/ad_video_2_tag`
  - added the new optional request property `oneOf[subschema #1: operate on item batch]/oneOf[#/components/schemas/CatalogsRetailBatchRequest]/items/items/anyOf[#/components/schemas/CatalogsUpsertRetailItem]/attributes/allOf[#/components/schemas/UpdatableItemAttributes]/android_deep_link`
  - added the new optional request property `oneOf[subschema #1: operate on item batch]/oneOf[#/components/schemas/CatalogsRetailBatchRequest]/items/items/anyOf[#/components/schemas/CatalogsUpsertRetailItem]/attributes/allOf[#/components/schemas/UpdatableItemAttributes]/ios_deep_link`
  - added the new optional request property `oneOf[subschema #1: operate on item batch]/oneOf[#/components/schemas/CatalogsRetailBatchRequest]/items/items/anyOf[#/components/schemas/CatalogsUpsertRetailItem]/attributes/allOf[subschema #3]/ad_video_0_link`
  - added the new optional request property `oneOf[subschema #1: operate on item batch]/oneOf[#/components/schemas/CatalogsRetailBatchRequest]/items/items/anyOf[#/components/schemas/CatalogsUpsertRetailItem]/attributes/allOf[subschema #3]/ad_video_0_tag`
  - added the new optional request property `oneOf[subschema #1: operate on item batch]/oneOf[#/components/schemas/CatalogsRetailBatchRequest]/items/items/anyOf[#/components/schemas/CatalogsUpsertRetailItem]/attributes/allOf[subschema #3]/ad_video_1_link`
  - added the new optional request property `oneOf[subschema #1: operate on item batch]/oneOf[#/components/schemas/CatalogsRetailBatchRequest]/items/items/anyOf[#/components/schemas/CatalogsUpsertRetailItem]/attributes/allOf[subschema #3]/ad_video_1_tag`
  - added the new optional request property `oneOf[subschema #1: operate on item batch]/oneOf[#/components/schemas/CatalogsRetailBatchRequest]/items/items/anyOf[#/components/schemas/CatalogsUpsertRetailItem]/attributes/allOf[subschema #3]/ad_video_2_link`
  - added the new optional request property `oneOf[subschema #1: operate on item batch]/oneOf[#/components/schemas/CatalogsRetailBatchRequest]/items/items/anyOf[#/components/schemas/CatalogsUpsertRetailItem]/attributes/allOf[subschema #3]/ad_video_2_tag`
  - added the new optional request property `oneOf[subschema #2: legacy_retail_only]/oneOf[#/components/schemas/CatalogsItemsCreateBatchRequest]/items/items/attributes/allOf[#/components/schemas/UpdatableItemAttributes]/ad_video_0_link`
  - added the new optional request property `oneOf[subschema #2: legacy_retail_only]/oneOf[#/components/schemas/CatalogsItemsCreateBatchRequest]/items/items/attributes/allOf[#/components/schemas/UpdatableItemAttributes]/ad_video_0_tag`
  - …47 more
- **2025-10-16** (v5) `14c297539b64` — 26 info
  - added the new optional request property `oneOf[subschema #1: operate on item batch]/oneOf[#/components/schemas/CatalogsRetailBatchRequest]/items/items/anyOf[#/components/schemas/CatalogsCreateRetailItem]/attributes/allOf[#/components/schemas/UpdatableItemAttributes]/installment_price`
  - added the new optional request property `oneOf[subschema #1: operate on item batch]/oneOf[#/components/schemas/CatalogsRetailBatchRequest]/items/items/anyOf[#/components/schemas/CatalogsCreateRetailItem]/attributes/allOf[#/components/schemas/UpdatableItemAttributes]/sale_price_effective_date`
  - added the new optional request property `oneOf[subschema #1: operate on item batch]/oneOf[#/components/schemas/CatalogsRetailBatchRequest]/items/items/anyOf[#/components/schemas/CatalogsCreateRetailItem]/attributes/allOf[#/components/schemas/UpdatableItemAttributes]/unit_pricing_base_measure`
  - added the new optional request property `oneOf[subschema #1: operate on item batch]/oneOf[#/components/schemas/CatalogsRetailBatchRequest]/items/items/anyOf[#/components/schemas/CatalogsCreateRetailItem]/attributes/allOf[#/components/schemas/UpdatableItemAttributes]/unit_pricing_measure`
  - added the new optional request property `oneOf[subschema #1: operate on item batch]/oneOf[#/components/schemas/CatalogsRetailBatchRequest]/items/items/anyOf[#/components/schemas/CatalogsUpdateRetailItem]/attributes/installment_price`
  - added the new optional request property `oneOf[subschema #1: operate on item batch]/oneOf[#/components/schemas/CatalogsRetailBatchRequest]/items/items/anyOf[#/components/schemas/CatalogsUpdateRetailItem]/attributes/sale_price_effective_date`
  - added the new optional request property `oneOf[subschema #1: operate on item batch]/oneOf[#/components/schemas/CatalogsRetailBatchRequest]/items/items/anyOf[#/components/schemas/CatalogsUpdateRetailItem]/attributes/unit_pricing_base_measure`
  - added the new optional request property `oneOf[subschema #1: operate on item batch]/oneOf[#/components/schemas/CatalogsRetailBatchRequest]/items/items/anyOf[#/components/schemas/CatalogsUpdateRetailItem]/attributes/unit_pricing_measure`
  - added the new optional request property `oneOf[subschema #1: operate on item batch]/oneOf[#/components/schemas/CatalogsRetailBatchRequest]/items/items/anyOf[#/components/schemas/CatalogsUpsertRetailItem]/attributes/allOf[#/components/schemas/UpdatableItemAttributes]/installment_price`
  - added the new optional request property `oneOf[subschema #1: operate on item batch]/oneOf[#/components/schemas/CatalogsRetailBatchRequest]/items/items/anyOf[#/components/schemas/CatalogsUpsertRetailItem]/attributes/allOf[#/components/schemas/UpdatableItemAttributes]/sale_price_effective_date`
  - added the new optional request property `oneOf[subschema #1: operate on item batch]/oneOf[#/components/schemas/CatalogsRetailBatchRequest]/items/items/anyOf[#/components/schemas/CatalogsUpsertRetailItem]/attributes/allOf[#/components/schemas/UpdatableItemAttributes]/unit_pricing_base_measure`
  - added the new optional request property `oneOf[subschema #1: operate on item batch]/oneOf[#/components/schemas/CatalogsRetailBatchRequest]/items/items/anyOf[#/components/schemas/CatalogsUpsertRetailItem]/attributes/allOf[#/components/schemas/UpdatableItemAttributes]/unit_pricing_measure`
  - added the new optional request property `oneOf[subschema #2: legacy_retail_only]/oneOf[#/components/schemas/CatalogsItemsCreateBatchRequest]/items/items/attributes/allOf[#/components/schemas/UpdatableItemAttributes]/installment_price`
  - added the new optional request property `oneOf[subschema #2: legacy_retail_only]/oneOf[#/components/schemas/CatalogsItemsCreateBatchRequest]/items/items/attributes/allOf[#/components/schemas/UpdatableItemAttributes]/sale_price_effective_date`
  - added the new optional request property `oneOf[subschema #2: legacy_retail_only]/oneOf[#/components/schemas/CatalogsItemsCreateBatchRequest]/items/items/attributes/allOf[#/components/schemas/UpdatableItemAttributes]/unit_pricing_base_measure`
  - added the new optional request property `oneOf[subschema #2: legacy_retail_only]/oneOf[#/components/schemas/CatalogsItemsCreateBatchRequest]/items/items/attributes/allOf[#/components/schemas/UpdatableItemAttributes]/unit_pricing_measure`
  - added the new optional request property `oneOf[subschema #2: legacy_retail_only]/oneOf[#/components/schemas/CatalogsItemsUpdateBatchRequest]/items/items/attributes/installment_price`
  - added the new optional request property `oneOf[subschema #2: legacy_retail_only]/oneOf[#/components/schemas/CatalogsItemsUpdateBatchRequest]/items/items/attributes/sale_price_effective_date`
  - added the new optional request property `oneOf[subschema #2: legacy_retail_only]/oneOf[#/components/schemas/CatalogsItemsUpdateBatchRequest]/items/items/attributes/unit_pricing_base_measure`
  - added the new optional request property `oneOf[subschema #2: legacy_retail_only]/oneOf[#/components/schemas/CatalogsItemsUpdateBatchRequest]/items/items/attributes/unit_pricing_measure`
  - added the new optional request property `oneOf[subschema #2: legacy_retail_only]/oneOf[#/components/schemas/CatalogsItemsUpsertBatchRequest]/items/items/attributes/allOf[#/components/schemas/UpdatableItemAttributes]/installment_price`
  - added the new optional request property `oneOf[subschema #2: legacy_retail_only]/oneOf[#/components/schemas/CatalogsItemsUpsertBatchRequest]/items/items/attributes/allOf[#/components/schemas/UpdatableItemAttributes]/sale_price_effective_date`
  - added the new optional request property `oneOf[subschema #2: legacy_retail_only]/oneOf[#/components/schemas/CatalogsItemsUpsertBatchRequest]/items/items/attributes/allOf[#/components/schemas/UpdatableItemAttributes]/unit_pricing_base_measure`
  - added the new optional request property `oneOf[subschema #2: legacy_retail_only]/oneOf[#/components/schemas/CatalogsItemsUpsertBatchRequest]/items/items/attributes/allOf[#/components/schemas/UpdatableItemAttributes]/unit_pricing_measure`
  - added the new `promotion_id` enum value to the request property `oneOf[subschema #1: operate on item batch]/oneOf[#/components/schemas/CatalogsRetailBatchRequest]/items/items/anyOf[#/components/schemas/CatalogsUpdateRetailItem]/update_mask/items/`
  - added the new `promotion_id` enum value to the request property `oneOf[subschema #2: legacy_retail_only]/oneOf[#/components/schemas/CatalogsItemsUpdateBatchRequest]/items/items/update_mask/items/`
- **2025-08-14** (v5) `7d64d863909a` — 4 info
  - added the new optional request property `oneOf[subschema #1: operate on item batch]/oneOf[#/components/schemas/CatalogsRetailBatchRequest]/items/items/anyOf[#/components/schemas/CatalogsCreateRetailItem]/attributes/allOf[subschema #1]/save_pin_disabled`
  - added the new optional request property `oneOf[subschema #1: operate on item batch]/oneOf[#/components/schemas/CatalogsRetailBatchRequest]/items/items/anyOf[#/components/schemas/CatalogsUpsertRetailItem]/attributes/allOf[subschema #1]/save_pin_disabled`
  - added the new optional request property `oneOf[subschema #2: legacy_retail_only]/oneOf[#/components/schemas/CatalogsItemsCreateBatchRequest]/items/items/attributes/allOf[subschema #1]/save_pin_disabled`
  - added the new optional request property `oneOf[subschema #2: legacy_retail_only]/oneOf[#/components/schemas/CatalogsItemsUpsertBatchRequest]/items/items/attributes/allOf[subschema #1]/save_pin_disabled`
- **2025-08-12** (v5) `8fb7ab040159` — 7 info
  - added the new optional request property `oneOf[subschema #1: operate on item batch]/oneOf[#/components/schemas/CatalogsRetailBatchRequest]/catalog_id`
  - added the new optional request property `oneOf[subschema #1: operate on item batch]/oneOf[#/components/schemas/CatalogsRetailBatchRequest]/items/items/anyOf[#/components/schemas/CatalogsCreateRetailItem]/attributes/allOf[#/components/schemas/UpdatableItemAttributes]/promotion_id`
  - added the new optional request property `oneOf[subschema #1: operate on item batch]/oneOf[#/components/schemas/CatalogsRetailBatchRequest]/items/items/anyOf[#/components/schemas/CatalogsUpdateRetailItem]/attributes/promotion_id`
  - added the new optional request property `oneOf[subschema #1: operate on item batch]/oneOf[#/components/schemas/CatalogsRetailBatchRequest]/items/items/anyOf[#/components/schemas/CatalogsUpsertRetailItem]/attributes/allOf[#/components/schemas/UpdatableItemAttributes]/promotion_id`
  - added the new optional request property `oneOf[subschema #2: legacy_retail_only]/oneOf[#/components/schemas/CatalogsItemsCreateBatchRequest]/items/items/attributes/allOf[#/components/schemas/UpdatableItemAttributes]/promotion_id`
  - added the new optional request property `oneOf[subschema #2: legacy_retail_only]/oneOf[#/components/schemas/CatalogsItemsUpdateBatchRequest]/items/items/attributes/promotion_id`
  - added the new optional request property `oneOf[subschema #2: legacy_retail_only]/oneOf[#/components/schemas/CatalogsItemsUpsertBatchRequest]/items/items/attributes/allOf[#/components/schemas/UpdatableItemAttributes]/promotion_id`
- **2025-07-16** (v5) `43134ca41f18` — 30 warning, 406 info
  - the `oneOf[subschema #1: operate on item batch]/oneOf[#/components/schemas/CatalogsRetailBatchRequest]/items/items/anyOf[#/components/schemas/CatalogsCreateRetailItem]/attributes/allOf[#/components/schemas/UpdatableItemAttributes]/custom_label_0` request property's maxLength was set to `511`
  - the `oneOf[subschema #1: operate on item batch]/oneOf[#/components/schemas/CatalogsRetailBatchRequest]/items/items/anyOf[#/components/schemas/CatalogsCreateRetailItem]/attributes/allOf[#/components/schemas/UpdatableItemAttributes]/custom_label_1` request property's maxLength was set to `511`
  - the `oneOf[subschema #1: operate on item batch]/oneOf[#/components/schemas/CatalogsRetailBatchRequest]/items/items/anyOf[#/components/schemas/CatalogsCreateRetailItem]/attributes/allOf[#/components/schemas/UpdatableItemAttributes]/custom_label_2` request property's maxLength was set to `511`
  - the `oneOf[subschema #1: operate on item batch]/oneOf[#/components/schemas/CatalogsRetailBatchRequest]/items/items/anyOf[#/components/schemas/CatalogsCreateRetailItem]/attributes/allOf[#/components/schemas/UpdatableItemAttributes]/custom_label_3` request property's maxLength was set to `511`
  - the `oneOf[subschema #1: operate on item batch]/oneOf[#/components/schemas/CatalogsRetailBatchRequest]/items/items/anyOf[#/components/schemas/CatalogsCreateRetailItem]/attributes/allOf[#/components/schemas/UpdatableItemAttributes]/custom_label_4` request property's maxLength was set to `511`
  - the `oneOf[subschema #1: operate on item batch]/oneOf[#/components/schemas/CatalogsRetailBatchRequest]/items/items/anyOf[#/components/schemas/CatalogsUpdateRetailItem]/attributes/custom_label_0` request property's maxLength was set to `511`
  - the `oneOf[subschema #1: operate on item batch]/oneOf[#/components/schemas/CatalogsRetailBatchRequest]/items/items/anyOf[#/components/schemas/CatalogsUpdateRetailItem]/attributes/custom_label_1` request property's maxLength was set to `511`
  - the `oneOf[subschema #1: operate on item batch]/oneOf[#/components/schemas/CatalogsRetailBatchRequest]/items/items/anyOf[#/components/schemas/CatalogsUpdateRetailItem]/attributes/custom_label_2` request property's maxLength was set to `511`
  - the `oneOf[subschema #1: operate on item batch]/oneOf[#/components/schemas/CatalogsRetailBatchRequest]/items/items/anyOf[#/components/schemas/CatalogsUpdateRetailItem]/attributes/custom_label_3` request property's maxLength was set to `511`
  - the `oneOf[subschema #1: operate on item batch]/oneOf[#/components/schemas/CatalogsRetailBatchRequest]/items/items/anyOf[#/components/schemas/CatalogsUpdateRetailItem]/attributes/custom_label_4` request property's maxLength was set to `511`
  - the `oneOf[subschema #1: operate on item batch]/oneOf[#/components/schemas/CatalogsRetailBatchRequest]/items/items/anyOf[#/components/schemas/CatalogsUpsertRetailItem]/attributes/allOf[#/components/schemas/UpdatableItemAttributes]/custom_label_0` request property's maxLength was set to `511`
  - the `oneOf[subschema #1: operate on item batch]/oneOf[#/components/schemas/CatalogsRetailBatchRequest]/items/items/anyOf[#/components/schemas/CatalogsUpsertRetailItem]/attributes/allOf[#/components/schemas/UpdatableItemAttributes]/custom_label_1` request property's maxLength was set to `511`
  - the `oneOf[subschema #1: operate on item batch]/oneOf[#/components/schemas/CatalogsRetailBatchRequest]/items/items/anyOf[#/components/schemas/CatalogsUpsertRetailItem]/attributes/allOf[#/components/schemas/UpdatableItemAttributes]/custom_label_2` request property's maxLength was set to `511`
  - the `oneOf[subschema #1: operate on item batch]/oneOf[#/components/schemas/CatalogsRetailBatchRequest]/items/items/anyOf[#/components/schemas/CatalogsUpsertRetailItem]/attributes/allOf[#/components/schemas/UpdatableItemAttributes]/custom_label_3` request property's maxLength was set to `511`
  - the `oneOf[subschema #1: operate on item batch]/oneOf[#/components/schemas/CatalogsRetailBatchRequest]/items/items/anyOf[#/components/schemas/CatalogsUpsertRetailItem]/attributes/allOf[#/components/schemas/UpdatableItemAttributes]/custom_label_4` request property's maxLength was set to `511`
  - the `oneOf[subschema #2: legacy_retail_only]/oneOf[#/components/schemas/CatalogsItemsCreateBatchRequest]/items/items/attributes/allOf[#/components/schemas/UpdatableItemAttributes]/custom_label_0` request property's maxLength was set to `511`
  - the `oneOf[subschema #2: legacy_retail_only]/oneOf[#/components/schemas/CatalogsItemsCreateBatchRequest]/items/items/attributes/allOf[#/components/schemas/UpdatableItemAttributes]/custom_label_1` request property's maxLength was set to `511`
  - the `oneOf[subschema #2: legacy_retail_only]/oneOf[#/components/schemas/CatalogsItemsCreateBatchRequest]/items/items/attributes/allOf[#/components/schemas/UpdatableItemAttributes]/custom_label_2` request property's maxLength was set to `511`
  - the `oneOf[subschema #2: legacy_retail_only]/oneOf[#/components/schemas/CatalogsItemsCreateBatchRequest]/items/items/attributes/allOf[#/components/schemas/UpdatableItemAttributes]/custom_label_3` request property's maxLength was set to `511`
  - the `oneOf[subschema #2: legacy_retail_only]/oneOf[#/components/schemas/CatalogsItemsCreateBatchRequest]/items/items/attributes/allOf[#/components/schemas/UpdatableItemAttributes]/custom_label_4` request property's maxLength was set to `511`
  - the `oneOf[subschema #2: legacy_retail_only]/oneOf[#/components/schemas/CatalogsItemsUpdateBatchRequest]/items/items/attributes/custom_label_0` request property's maxLength was set to `511`
  - the `oneOf[subschema #2: legacy_retail_only]/oneOf[#/components/schemas/CatalogsItemsUpdateBatchRequest]/items/items/attributes/custom_label_1` request property's maxLength was set to `511`
  - the `oneOf[subschema #2: legacy_retail_only]/oneOf[#/components/schemas/CatalogsItemsUpdateBatchRequest]/items/items/attributes/custom_label_2` request property's maxLength was set to `511`
  - the `oneOf[subschema #2: legacy_retail_only]/oneOf[#/components/schemas/CatalogsItemsUpdateBatchRequest]/items/items/attributes/custom_label_3` request property's maxLength was set to `511`
  - the `oneOf[subschema #2: legacy_retail_only]/oneOf[#/components/schemas/CatalogsItemsUpdateBatchRequest]/items/items/attributes/custom_label_4` request property's maxLength was set to `511`
  - the `oneOf[subschema #2: legacy_retail_only]/oneOf[#/components/schemas/CatalogsItemsUpsertBatchRequest]/items/items/attributes/allOf[#/components/schemas/UpdatableItemAttributes]/custom_label_0` request property's maxLength was set to `511`
  - the `oneOf[subschema #2: legacy_retail_only]/oneOf[#/components/schemas/CatalogsItemsUpsertBatchRequest]/items/items/attributes/allOf[#/components/schemas/UpdatableItemAttributes]/custom_label_1` request property's maxLength was set to `511`
  - the `oneOf[subschema #2: legacy_retail_only]/oneOf[#/components/schemas/CatalogsItemsUpsertBatchRequest]/items/items/attributes/allOf[#/components/schemas/UpdatableItemAttributes]/custom_label_2` request property's maxLength was set to `511`
  - the `oneOf[subschema #2: legacy_retail_only]/oneOf[#/components/schemas/CatalogsItemsUpsertBatchRequest]/items/items/attributes/allOf[#/components/schemas/UpdatableItemAttributes]/custom_label_3` request property's maxLength was set to `511`
  - the `oneOf[subschema #2: legacy_retail_only]/oneOf[#/components/schemas/CatalogsItemsUpsertBatchRequest]/items/items/attributes/allOf[#/components/schemas/UpdatableItemAttributes]/custom_label_4` request property's maxLength was set to `511`
  - added the new optional request property `oneOf[subschema #1: operate on item batch]/oneOf[#/components/schemas/CatalogsRetailBatchRequest]/items/items/anyOf[#/components/schemas/CatalogsCreateRetailItem]/attributes/allOf[#/components/schemas/UpdatableItemAttributes]/ad_image_0_link`
  - added the new optional request property `oneOf[subschema #1: operate on item batch]/oneOf[#/components/schemas/CatalogsRetailBatchRequest]/items/items/anyOf[#/components/schemas/CatalogsCreateRetailItem]/attributes/allOf[#/components/schemas/UpdatableItemAttributes]/ad_image_0_tag`
  - added the new optional request property `oneOf[subschema #1: operate on item batch]/oneOf[#/components/schemas/CatalogsRetailBatchRequest]/items/items/anyOf[#/components/schemas/CatalogsCreateRetailItem]/attributes/allOf[#/components/schemas/UpdatableItemAttributes]/ad_image_10_link`
  - added the new optional request property `oneOf[subschema #1: operate on item batch]/oneOf[#/components/schemas/CatalogsRetailBatchRequest]/items/items/anyOf[#/components/schemas/CatalogsCreateRetailItem]/attributes/allOf[#/components/schemas/UpdatableItemAttributes]/ad_image_10_tag`
  - added the new optional request property `oneOf[subschema #1: operate on item batch]/oneOf[#/components/schemas/CatalogsRetailBatchRequest]/items/items/anyOf[#/components/schemas/CatalogsCreateRetailItem]/attributes/allOf[#/components/schemas/UpdatableItemAttributes]/ad_image_11_link`
  - added the new optional request property `oneOf[subschema #1: operate on item batch]/oneOf[#/components/schemas/CatalogsRetailBatchRequest]/items/items/anyOf[#/components/schemas/CatalogsCreateRetailItem]/attributes/allOf[#/components/schemas/UpdatableItemAttributes]/ad_image_11_tag`
  - added the new optional request property `oneOf[subschema #1: operate on item batch]/oneOf[#/components/schemas/CatalogsRetailBatchRequest]/items/items/anyOf[#/components/schemas/CatalogsCreateRetailItem]/attributes/allOf[#/components/schemas/UpdatableItemAttributes]/ad_image_12_link`
  - added the new optional request property `oneOf[subschema #1: operate on item batch]/oneOf[#/components/schemas/CatalogsRetailBatchRequest]/items/items/anyOf[#/components/schemas/CatalogsCreateRetailItem]/attributes/allOf[#/components/schemas/UpdatableItemAttributes]/ad_image_12_tag`
  - added the new optional request property `oneOf[subschema #1: operate on item batch]/oneOf[#/components/schemas/CatalogsRetailBatchRequest]/items/items/anyOf[#/components/schemas/CatalogsCreateRetailItem]/attributes/allOf[#/components/schemas/UpdatableItemAttributes]/ad_image_13_link`
  - added the new optional request property `oneOf[subschema #1: operate on item batch]/oneOf[#/components/schemas/CatalogsRetailBatchRequest]/items/items/anyOf[#/components/schemas/CatalogsCreateRetailItem]/attributes/allOf[#/components/schemas/UpdatableItemAttributes]/ad_image_13_tag`
  - …396 more
- **2025-04-04** (v5) `10f9eba4ad97` — 4 breaking, 42 info
  - added `subschema #3` to the `oneOf[subschema #1: operate on item batch]/oneOf[#/components/schemas/CatalogsRetailBatchRequest]/items/items/anyOf[#/components/schemas/CatalogsCreateRetailItem]/attributes` request property `allOf` list
  - added `subschema #3` to the `oneOf[subschema #1: operate on item batch]/oneOf[#/components/schemas/CatalogsRetailBatchRequest]/items/items/anyOf[#/components/schemas/CatalogsUpsertRetailItem]/attributes` request property `allOf` list
  - added `subschema #3` to the `oneOf[subschema #2: legacy_retail_only]/oneOf[#/components/schemas/CatalogsItemsCreateBatchRequest]/items/items/attributes` request property `allOf` list
  - added `subschema #3` to the `oneOf[subschema #2: legacy_retail_only]/oneOf[#/components/schemas/CatalogsItemsUpsertBatchRequest]/items/items/attributes` request property `allOf` list
  - api tag `catalog_items` added
  - api tag `catalogs` removed
  - added the new optional request property `oneOf[subschema #1: operate on item batch]/oneOf[#/components/schemas/CatalogsRetailBatchRequest]/items/items/anyOf[#/components/schemas/CatalogsCreateRetailItem]/attributes/allOf[#/components/schemas/UpdatableItemAttributes]/custom_number_0`
  - added the new optional request property `oneOf[subschema #1: operate on item batch]/oneOf[#/components/schemas/CatalogsRetailBatchRequest]/items/items/anyOf[#/components/schemas/CatalogsCreateRetailItem]/attributes/allOf[#/components/schemas/UpdatableItemAttributes]/custom_number_1`
  - added the new optional request property `oneOf[subschema #1: operate on item batch]/oneOf[#/components/schemas/CatalogsRetailBatchRequest]/items/items/anyOf[#/components/schemas/CatalogsCreateRetailItem]/attributes/allOf[#/components/schemas/UpdatableItemAttributes]/custom_number_2`
  - added the new optional request property `oneOf[subschema #1: operate on item batch]/oneOf[#/components/schemas/CatalogsRetailBatchRequest]/items/items/anyOf[#/components/schemas/CatalogsCreateRetailItem]/attributes/allOf[#/components/schemas/UpdatableItemAttributes]/custom_number_3`
  - added the new optional request property `oneOf[subschema #1: operate on item batch]/oneOf[#/components/schemas/CatalogsRetailBatchRequest]/items/items/anyOf[#/components/schemas/CatalogsCreateRetailItem]/attributes/allOf[#/components/schemas/UpdatableItemAttributes]/custom_number_4`
  - added the new optional request property `oneOf[subschema #1: operate on item batch]/oneOf[#/components/schemas/CatalogsRetailBatchRequest]/items/items/anyOf[#/components/schemas/CatalogsUpdateRetailItem]/attributes/custom_number_0`
  - added the new optional request property `oneOf[subschema #1: operate on item batch]/oneOf[#/components/schemas/CatalogsRetailBatchRequest]/items/items/anyOf[#/components/schemas/CatalogsUpdateRetailItem]/attributes/custom_number_1`
  - added the new optional request property `oneOf[subschema #1: operate on item batch]/oneOf[#/components/schemas/CatalogsRetailBatchRequest]/items/items/anyOf[#/components/schemas/CatalogsUpdateRetailItem]/attributes/custom_number_2`
  - added the new optional request property `oneOf[subschema #1: operate on item batch]/oneOf[#/components/schemas/CatalogsRetailBatchRequest]/items/items/anyOf[#/components/schemas/CatalogsUpdateRetailItem]/attributes/custom_number_3`
  - added the new optional request property `oneOf[subschema #1: operate on item batch]/oneOf[#/components/schemas/CatalogsRetailBatchRequest]/items/items/anyOf[#/components/schemas/CatalogsUpdateRetailItem]/attributes/custom_number_4`
  - added the new optional request property `oneOf[subschema #1: operate on item batch]/oneOf[#/components/schemas/CatalogsRetailBatchRequest]/items/items/anyOf[#/components/schemas/CatalogsUpsertRetailItem]/attributes/allOf[#/components/schemas/UpdatableItemAttributes]/custom_number_0`
  - added the new optional request property `oneOf[subschema #1: operate on item batch]/oneOf[#/components/schemas/CatalogsRetailBatchRequest]/items/items/anyOf[#/components/schemas/CatalogsUpsertRetailItem]/attributes/allOf[#/components/schemas/UpdatableItemAttributes]/custom_number_1`
  - added the new optional request property `oneOf[subschema #1: operate on item batch]/oneOf[#/components/schemas/CatalogsRetailBatchRequest]/items/items/anyOf[#/components/schemas/CatalogsUpsertRetailItem]/attributes/allOf[#/components/schemas/UpdatableItemAttributes]/custom_number_2`
  - added the new optional request property `oneOf[subschema #1: operate on item batch]/oneOf[#/components/schemas/CatalogsRetailBatchRequest]/items/items/anyOf[#/components/schemas/CatalogsUpsertRetailItem]/attributes/allOf[#/components/schemas/UpdatableItemAttributes]/custom_number_3`
  - added the new optional request property `oneOf[subschema #1: operate on item batch]/oneOf[#/components/schemas/CatalogsRetailBatchRequest]/items/items/anyOf[#/components/schemas/CatalogsUpsertRetailItem]/attributes/allOf[#/components/schemas/UpdatableItemAttributes]/custom_number_4`
  - added the new optional request property `oneOf[subschema #2: legacy_retail_only]/oneOf[#/components/schemas/CatalogsItemsCreateBatchRequest]/items/items/attributes/allOf[#/components/schemas/UpdatableItemAttributes]/custom_number_0`
  - added the new optional request property `oneOf[subschema #2: legacy_retail_only]/oneOf[#/components/schemas/CatalogsItemsCreateBatchRequest]/items/items/attributes/allOf[#/components/schemas/UpdatableItemAttributes]/custom_number_1`
  - added the new optional request property `oneOf[subschema #2: legacy_retail_only]/oneOf[#/components/schemas/CatalogsItemsCreateBatchRequest]/items/items/attributes/allOf[#/components/schemas/UpdatableItemAttributes]/custom_number_2`
  - added the new optional request property `oneOf[subschema #2: legacy_retail_only]/oneOf[#/components/schemas/CatalogsItemsCreateBatchRequest]/items/items/attributes/allOf[#/components/schemas/UpdatableItemAttributes]/custom_number_3`
  - added the new optional request property `oneOf[subschema #2: legacy_retail_only]/oneOf[#/components/schemas/CatalogsItemsCreateBatchRequest]/items/items/attributes/allOf[#/components/schemas/UpdatableItemAttributes]/custom_number_4`
  - added the new optional request property `oneOf[subschema #2: legacy_retail_only]/oneOf[#/components/schemas/CatalogsItemsUpdateBatchRequest]/items/items/attributes/custom_number_0`
  - added the new optional request property `oneOf[subschema #2: legacy_retail_only]/oneOf[#/components/schemas/CatalogsItemsUpdateBatchRequest]/items/items/attributes/custom_number_1`
  - added the new optional request property `oneOf[subschema #2: legacy_retail_only]/oneOf[#/components/schemas/CatalogsItemsUpdateBatchRequest]/items/items/attributes/custom_number_2`
  - added the new optional request property `oneOf[subschema #2: legacy_retail_only]/oneOf[#/components/schemas/CatalogsItemsUpdateBatchRequest]/items/items/attributes/custom_number_3`
  - added the new optional request property `oneOf[subschema #2: legacy_retail_only]/oneOf[#/components/schemas/CatalogsItemsUpdateBatchRequest]/items/items/attributes/custom_number_4`
  - added the new optional request property `oneOf[subschema #2: legacy_retail_only]/oneOf[#/components/schemas/CatalogsItemsUpsertBatchRequest]/items/items/attributes/allOf[#/components/schemas/UpdatableItemAttributes]/custom_number_0`
  - added the new optional request property `oneOf[subschema #2: legacy_retail_only]/oneOf[#/components/schemas/CatalogsItemsUpsertBatchRequest]/items/items/attributes/allOf[#/components/schemas/UpdatableItemAttributes]/custom_number_1`
  - added the new optional request property `oneOf[subschema #2: legacy_retail_only]/oneOf[#/components/schemas/CatalogsItemsUpsertBatchRequest]/items/items/attributes/allOf[#/components/schemas/UpdatableItemAttributes]/custom_number_2`
  - added the new optional request property `oneOf[subschema #2: legacy_retail_only]/oneOf[#/components/schemas/CatalogsItemsUpsertBatchRequest]/items/items/attributes/allOf[#/components/schemas/UpdatableItemAttributes]/custom_number_3`
  - added the new optional request property `oneOf[subschema #2: legacy_retail_only]/oneOf[#/components/schemas/CatalogsItemsUpsertBatchRequest]/items/items/attributes/allOf[#/components/schemas/UpdatableItemAttributes]/custom_number_4`
  - added the new `custom_number_0` enum value to the request property `oneOf[subschema #1: operate on item batch]/oneOf[#/components/schemas/CatalogsRetailBatchRequest]/items/items/anyOf[#/components/schemas/CatalogsUpdateRetailItem]/update_mask/items/`
  - added the new `custom_number_0` enum value to the request property `oneOf[subschema #2: legacy_retail_only]/oneOf[#/components/schemas/CatalogsItemsUpdateBatchRequest]/items/items/update_mask/items/`
  - added the new `custom_number_1` enum value to the request property `oneOf[subschema #1: operate on item batch]/oneOf[#/components/schemas/CatalogsRetailBatchRequest]/items/items/anyOf[#/components/schemas/CatalogsUpdateRetailItem]/update_mask/items/`
  - added the new `custom_number_1` enum value to the request property `oneOf[subschema #2: legacy_retail_only]/oneOf[#/components/schemas/CatalogsItemsUpdateBatchRequest]/items/items/update_mask/items/`
  - …6 more
- …earlier changes are on the page: https://skmtc.dev/pinterest/apis/pinterest-rest-api/changes/catalogs/items/batch/post

---

[Operation](https://skmtc.dev/pinterest/apis/pinterest-rest-api/docs/catalogs/items/batch/post.md) · [API](https://skmtc.dev/pinterest/apis/pinterest-rest-api.md) · [Page](https://skmtc.dev/pinterest/apis/pinterest-rest-api/changes/catalogs/items/batch/post)
