Updated API from documentation release

Author: ct-sdks[bot]

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: |

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]$