Updated API from documentation release

ct-sdks[bot] · ct-sdks[bot] · commit 356beed6a818 · 2025-05-01T07:52:53.000Z
diff --git a/api-specs/api/types/product/ProductDraft.raml b/api-specs/api/types/product/ProductDraft.raml
@@ -37,7 +37,7 @@ properties:
   categoryOrderHints?:
     type: CategoryOrderHints
     description: |
-      Numerical values to allow ordering of Products within a specified Category.
+      Numerical values to allow ordering of Products within specified Categories. If the referenced Categories are not also assigned in the `categories` field, an [InvalidOperation](ctp:api:type:InvalidOperationError) error is returned.
   metaTitle?:
     type: LocalizedString
     description: |
diff --git a/api-specs/api/types/product/updates/ProductSetCategoryOrderHintAction.raml b/api-specs/api/types/product/updates/ProductSetCategoryOrderHintAction.raml
@@ -8,7 +8,7 @@ properties:
   categoryId:
     type: string
     description: |
-      The `id` of the Category to add the `orderHint`.
+      The `id` of the Category to add the `orderHint`. If this Category is not assigned to the Product, an [InvalidOperation](ctp:api:type:InvalidOperationError) error is returned.
   orderHint?:
     type: string
     pattern: ^0\.[0-9]*[1-9]$
