Updated API from documentation release

Author: ct-sdks[bot]

api-specs/api/types/order/ReturnItem.raml

@@ -47,4 +47,4 @@ properties:
   createdAt:
     type: datetime
     description: |
-      Date and time (UTC) the Return Item was intitially created.
+      Date and time (UTC) the Return Item was initially created.

api-specs/history/api.raml

@@ -15,6 +15,9 @@ annotationTypes:
     allowedTargets:
       - API
     type: object
+  markDeprecated:
+    type: boolean
+    allowedTargets: TypeDeclaration
   products:
     allowedTargets:
       - API

api-specs/history/ruleset.xml

@@ -55,6 +55,7 @@
                 <option type="exclude">previousValue</option>
                 <option type="exclude">triggerPattern</option>
                 <option type="exclude">targetPattern</option>
+                <option type="exclude">perMethodTaxRate</option>
             </options>
         </rule>
         <rule>
@@ -123,6 +124,7 @@
           <option type="exclude">ProductVariantChannelAvailability:isOnStock</option>
           <option type="exclude">ShippingRate:isMatching</option>
           <option type="exclude">TrackingData:isReturn</option>
+          <option type="exclude">ProductVariant:isMatchingVariant</option>
         </options>
       </rule>
     </rules>

api-specs/history/types/PlatformInitiatedChange.raml

@@ -5,8 +5,21 @@ displayName: PlatformInitiatedChange
 description: Updates that are triggered automatically as a result of a user-initiated change.
 enum:
   - excludeAll
+  - addInheritedAssociate
+  - changeIncludedInStatistics
+  - changeInheritedAssociate
+  - changeLastVariantId
   - changeLineItemName
+  - changeLineItemPublished
   - changeReviewRatingStatistics
+  - changeTopLevelUnit
+  - removeInheritedAssociate
+  - setAncestors
   - setApplicationVersion
+  - setInheritedAssociates
+  - setInheritedStores
   - setIsValid
+  - setLineItemDeactivatedAt
+  - setProductCount
+  - setReservations
   - setVariantAvailability

api-specs/history/types/UpdateType.raml

@@ -36,7 +36,6 @@ enum:
   - 'addTransaction'
   - 'addVariant'
   - 'changeAddress'
-  - 'changeAmountAuthorized'
   - 'changeAmountPlanned'
   - 'changeAssetName'
   - 'changeAssetOrder'

api-specs/history/types/change/AddAssetChange.raml

@@ -23,3 +23,16 @@ properties:
   nextValue:
     type: Asset
     description: Value after the change.
+  catalogData:
+    type: string
+    description: |
+      Product data that was updated.
+
+      - `staged`, if the staged [ProductCatalogData](ctp:api:type:ProductCatalogData) was updated.
+      - `current`, if the current [ProductCatalogData](ctp:api:type:ProductCatalogData) was updated.
+  variant:
+    type: string
+    description: |
+      Identifier of the updated Product Variant.
+
+      This field holds the SKU, if defined; otherwise the key; otherwise the ID.

api-specs/history/types/change/AddAssociateChange.raml

@@ -1,5 +1,6 @@
 #%RAML 1.0 DataType
 (package): Change
+(markDeprecated): true
 type: Change
 displayName: AddAssociateChange
 description: Change triggered by the [Add Associate](ctp:api:type:BusinessUnitAddAssociateAction) update action.

api-specs/history/types/change/AddEnumValueChange.raml

@@ -14,8 +14,11 @@ properties:
     enum:
       - addEnumValue
   nextValue:
-    type: EnumValue
+    type: CustomFieldEnumValue
     description: Value after the change.
   fieldName:
     type: string
     description: Name of the updated [FieldDefinition](ctp:api:type:FieldDefinition).
+  attributeName:
+    type: string
+    description: Name of the updated [AttributeDefinition](ctp:api:type:AttributeDefinition).

api-specs/history/types/change/AddExternalImageChange.raml

@@ -26,5 +26,13 @@ properties:
   catalogData:
     type: string
     description: |
+      Product data that was updated.
+
       - `staged`, if the staged [ProductCatalogData](ctp:api:type:ProductCatalogData) was updated.
       - `current`, if the current [ProductCatalogData](ctp:api:type:ProductCatalogData) was updated.
+  variant:
+    type: string
+    description: |
+      Identifier of the updated Product Variant.
+
+      This field holds the SKU, if defined; otherwise the key; otherwise the ID.

api-specs/history/types/change/AddInheritedAssociateChange.raml

@@ -2,7 +2,7 @@
 (package): Change
 type: Change
 displayName: AddInheritedAssociateChange
-description: Change triggered by the [Add Associate](ctp:api:type:BusinessUnitAddAssociateAction) update action on a parent of a Business Unit in cases where [inheritance applies](/../api/associates-overview#conditions-for-inheritance).
+description: This change is initiated by background processes after the [Add Associate](ctp:api:type:BusinessUnitAddAssociateAction) update action is performed (if [Associates are inherited](/../api/associates-overview#inheritance-of-associates-and-their-roles)).
 discriminatorValue: AddInheritedAssociateChange
 properties:
   change: