diff --git a/lib/commercetools-api/src/Models/Product/ProductDraft.php b/lib/commercetools-api/src/Models/Product/ProductDraft.php
index 42699ac8c3d..d3f188bad14 100644
--- a/lib/commercetools-api/src/Models/Product/ProductDraft.php
+++ b/lib/commercetools-api/src/Models/Product/ProductDraft.php
@@ -89,7 +89,7 @@ public function getDescription();
     public function getCategories();
 
     /**
-     * <p>Numerical values to allow ordering of Products within a specified Category.</p>
+     * <p>Numerical values to allow ordering of Products within specified Categories. If the referenced Categories are not also assigned in the <code>categories</code> field, an <a href="ctp:api:type:InvalidOperationError">InvalidOperation</a> error is returned.</p>
      *
 
      * @return null|CategoryOrderHints
diff --git a/lib/commercetools-api/src/Models/Product/ProductDraftBuilder.php b/lib/commercetools-api/src/Models/Product/ProductDraftBuilder.php
index e10d6fab6f9..98b0158b58c 100644
--- a/lib/commercetools-api/src/Models/Product/ProductDraftBuilder.php
+++ b/lib/commercetools-api/src/Models/Product/ProductDraftBuilder.php
@@ -202,7 +202,7 @@ public function getCategories()
     }
 
     /**
-     * <p>Numerical values to allow ordering of Products within a specified Category.</p>
+     * <p>Numerical values to allow ordering of Products within specified Categories. If the referenced Categories are not also assigned in the <code>categories</code> field, an <a href="ctp:api:type:InvalidOperationError">InvalidOperation</a> error is returned.</p>
      *
 
      * @return null|CategoryOrderHints
diff --git a/lib/commercetools-api/src/Models/Product/ProductDraftModel.php b/lib/commercetools-api/src/Models/Product/ProductDraftModel.php
index d3f9d222a21..c36aab77818 100644
--- a/lib/commercetools-api/src/Models/Product/ProductDraftModel.php
+++ b/lib/commercetools-api/src/Models/Product/ProductDraftModel.php
@@ -301,7 +301,7 @@ public function getCategories()
     }
 
     /**
-     * <p>Numerical values to allow ordering of Products within a specified Category.</p>
+     * <p>Numerical values to allow ordering of Products within specified Categories. If the referenced Categories are not also assigned in the <code>categories</code> field, an <a href="ctp:api:type:InvalidOperationError">InvalidOperation</a> error is returned.</p>
      *
      *
      * @return null|CategoryOrderHints
diff --git a/lib/commercetools-api/src/Models/Product/ProductSetCategoryOrderHintAction.php b/lib/commercetools-api/src/Models/Product/ProductSetCategoryOrderHintAction.php
index ad07be0432d..16463ab68c6 100644
--- a/lib/commercetools-api/src/Models/Product/ProductSetCategoryOrderHintAction.php
+++ b/lib/commercetools-api/src/Models/Product/ProductSetCategoryOrderHintAction.php
@@ -18,7 +18,7 @@ interface ProductSetCategoryOrderHintAction extends ProductUpdateAction
     public const FIELD_STAGED = 'staged';
 
     /**
-     * <p>The <code>id</code> of the Category to add the <code>orderHint</code>.</p>
+     * <p>The <code>id</code> of the Category to add the <code>orderHint</code>. If this Category is not assigned to the Product, an <a href="ctp:api:type:InvalidOperationError">InvalidOperation</a> error is returned.</p>
      *
 
      * @return null|string
diff --git a/lib/commercetools-api/src/Models/Product/ProductSetCategoryOrderHintActionBuilder.php b/lib/commercetools-api/src/Models/Product/ProductSetCategoryOrderHintActionBuilder.php
index b5f8d8ed529..6f1336626e1 100644
--- a/lib/commercetools-api/src/Models/Product/ProductSetCategoryOrderHintActionBuilder.php
+++ b/lib/commercetools-api/src/Models/Product/ProductSetCategoryOrderHintActionBuilder.php
@@ -39,7 +39,7 @@ final class ProductSetCategoryOrderHintActionBuilder implements Builder
     private $staged;
 
     /**
-     * <p>The <code>id</code> of the Category to add the <code>orderHint</code>.</p>
+     * <p>The <code>id</code> of the Category to add the <code>orderHint</code>. If this Category is not assigned to the Product, an <a href="ctp:api:type:InvalidOperationError">InvalidOperation</a> error is returned.</p>
      *
 
      * @return null|string
diff --git a/lib/commercetools-api/src/Models/Product/ProductSetCategoryOrderHintActionModel.php b/lib/commercetools-api/src/Models/Product/ProductSetCategoryOrderHintActionModel.php
index 70820628b4c..c241078a38f 100644
--- a/lib/commercetools-api/src/Models/Product/ProductSetCategoryOrderHintActionModel.php
+++ b/lib/commercetools-api/src/Models/Product/ProductSetCategoryOrderHintActionModel.php
@@ -79,7 +79,7 @@ public function getAction()
     }
 
     /**
-     * <p>The <code>id</code> of the Category to add the <code>orderHint</code>.</p>
+     * <p>The <code>id</code> of the Category to add the <code>orderHint</code>. If this Category is not assigned to the Product, an <a href="ctp:api:type:InvalidOperationError">InvalidOperation</a> error is returned.</p>
      *
      *
      * @return null|string
diff --git a/references.txt b/references.txt
index 56e219f4e48..dee1025cf7c 100644
--- a/references.txt
+++ b/references.txt
@@ -405,3 +405,4 @@ f0288f95a5fe33fd2973df3f8290defb15129192
 761762c7caad45bc86b08db7021a033fff18ba90
 b32dd9c6633745d71fb526473fed6cc60e1fab0a
 dec65e707130185745930bde27ce78ae64ab29c1
+356beed6a818fbf0e5a7f5c4e938d02c2ca174ec