From 6ab0846165c47ff161076e72d9c53cc83743cc9a Mon Sep 17 00:00:00 2001
From: Traci Porter <traci.porter@bigcommerce.com>
Date: Fri, 13 Dec 2024 08:02:11 -0600
Subject: [PATCH] update-per-categories-feedback (#707)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

<!-- Ticket number or summary of work -->
# NO TICKET
See slack conversation:
https://bigcommerce.slack.com/archives/C05GVCPFW66/p1734016532530049

## What changed?
Updated the categories description

## Release notes draft

Enhancement
<!-- Provide an entry for the release notes using simple, conversational
language. Don't be too technical. Explain how the change will benefit
the merchant and link to the feature.

Examples:
* The newly-released [X feature] is now available to use. Now, you’ll be
able to [perform Y action].
* We're happy to announce [X feature], which can help you [perform Y
action].
* [X feature] helps you to create [Y response] using the [Z query
parameter]. Now, you can deliver [ex, localized shopping experiences for
your customers].
* Fixed a bug in the [X endpoint]. Now the [Y field] will appear when
you click [Z option]. -->
*

## Anything else?
<!-- Add related PRs, salient notes, additional ticket numbers, etc. -->

ping {names}
---
 reference/catalog/products_catalog.v3.yml | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/reference/catalog/products_catalog.v3.yml b/reference/catalog/products_catalog.v3.yml
index cac1403ff..c7ccad4c1 100644
--- a/reference/catalog/products_catalog.v3.yml
+++ b/reference/catalog/products_catalog.v3.yml
@@ -441,6 +441,7 @@ paths:
         - `type`
         - `weight`
         - `price`
+        - `categories` (required when you enable the V2 product experience in the control panel)
 
         **Read-Only Fields**
         - `id`
@@ -6986,7 +6987,7 @@ components:
         categories:
           type: array
           description: |
-            An array of IDs for the categories to which this product belongs. When updating a product, if an array of categories is supplied, all product categories will be overwritten. Does not accept more than 1,000 ID values.
+            An array of IDs for the categories to which this product belongs. You will overwrite all product categories when updating a product and supplying an array of categories. The limit is 1,000 ID values. When you enable the catalog V2 product experience in the control panel, you must include the categories array in the request body.
           required:
             - post
           items: