Updated API from documentation release

ct-sdks[bot] · ct-sdks[bot] · commit ebe8dbf7a0e9 · 2025-07-31T12:40:41.000Z
diff --git a/api-specs/api/examples/Inventory/InventoryEntrySetInventoryLimitsAction.json b/api-specs/api/examples/Inventory/InventoryEntrySetInventoryLimitsAction.json
@@ -0,0 +1,5 @@
+{
+  "action": "setInventoryLimits",
+  "minCartQuantity": 2,
+  "maxCartQuantity": 50
+}
diff --git a/api-specs/api/examples/inventories.example.json b/api-specs/api/examples/inventories.example.json
@@ -11,7 +11,9 @@
       "quantityOnStock": 4,
       "availableQuantity": 4,
       "createdAt": "2015-03-11T13:36:20.720Z",
-      "lastModifiedAt": "2015-03-11T13:36:20.720Z"
+      "lastModifiedAt": "2015-03-11T13:36:20.720Z",
+      "minCartQuantity": 2,
+      "maxCartQuantity": 50
     }
   ]
 }
diff --git a/api-specs/api/resources/inventory.raml b/api-specs/api/resources/inventory.raml
@@ -31,7 +31,12 @@ head:
         [Time](ctp:api:type:AttributeTimeType), and [DateTime](ctp:api:type:AttributeDateTimeType) attribute types.
 post:
   displayName: Create InventoryEntry
-  description: Produces the [InventoryEntryCreated](ctp:api:type:InventoryEntryCreatedMessage) Message.
+  description: |
+    Creates an InventoryEntry in the Project.
+
+    If quantity limits are provided, existing Line Items that reference a Product Variant with an SKU that matches the Inventory Entry can be affected. For more information, see [Quantity limits](/../api/carts-orders-overview#quantity-limits).
+
+    Produces the [InventoryEntryCreated](ctp:api:type:InventoryEntryCreatedMessage) Message.
   securedBy: [oauth_2_0: { scopes: ['manage_products:{projectKey}'] }]
   body:
     application/json:
diff --git a/api-specs/api/types/cart/updates/CartChangeLineItemQuantityAction.raml b/api-specs/api/types/cart/updates/CartChangeLineItemQuantityAction.raml
@@ -16,6 +16,8 @@ description: |
   in a single Cart update command.
 
   The [LineItem](ctp:api:type:LineItem) price is set as described in [Line Item price selection](/../api/pricing-and-discounts-overview#line-item-price-selection).
+
+  This action is subject to [InventoryEntry](ctp:api:type:InventoryEntry) min/max restrictions when applicable. For more information, see [Quantity limits](/../api/carts-orders-overview#quantity-limits).
 properties:
   lineItemId?:
     type: string
diff --git a/api-specs/api/types/cart/updates/CartSetLineItemSupplyChannelAction.raml b/api-specs/api/types/cart/updates/CartSetLineItemSupplyChannelAction.raml
@@ -6,6 +6,8 @@ discriminatorValue: setLineItemSupplyChannel
 example: !include ../../../examples/Cart/CartSetLineItemSupplyChannelAction.json
 description: |
   Performing this action does not reserve stock. Stock is only reserved at Order creation if the [InventoryMode](ctp:api:type:InventoryMode) of the Cart is `TrackOnly` or `ReserveOnOrder`.
+
+  This action is subject to [InventoryEntry](ctp:api:type:InventoryEntry) min/max restrictions when applicable. For more information, see [Quantity limits](/../api/carts-orders-overview#quantity-limits).
 properties:
   lineItemId?:
     type: string
diff --git a/api-specs/api/types/inventory/InventoryEntry.raml b/api-specs/api/types/inventory/InventoryEntry.raml
@@ -57,6 +57,16 @@ properties:
     format: int64
     description: |
       Available amount of stock (`quantityOnStock` - reserved).
+  minCartQuantity?:
+    type: integer
+    minimum: 1
+    description: |
+      Minimum quantity that can be added to a Cart. See [Quantity limits](/../api/carts-orders-overview#quantity-limits).
+  maxCartQuantity?:
+    type: integer
+    minimum: 1
+    description: |
+      Maximum quantity that can be added to a Cart. See [Quantity limits](/../api/carts-orders-overview#quantity-limits).
   restockableInDays?:
     type: number
     format: int64
diff --git a/api-specs/api/types/inventory/InventoryEntryDraft.raml b/api-specs/api/types/inventory/InventoryEntryDraft.raml
@@ -25,6 +25,16 @@ properties:
     format: int64
     description: |
       Overall amount of stock.
+  minCartQuantity?:
+    type: integer
+    minimum: 1
+    description: |
+      Minimum quantity that can be added to a Cart. See [Quantity limits](/../api/carts-orders-overview#quantity-limits).
+  maxCartQuantity?:
+    type: integer
+    minimum: 1
+    description: |
+      Maximum quantity that can be added to a Cart. See [Quantity limits](/../api/carts-orders-overview#quantity-limits).
   restockableInDays?:
     type: number
     format: int64
diff --git a/api-specs/api/types/inventory/updates/InventoryEntrySetInventoryLimitsAction.raml b/api-specs/api/types/inventory/updates/InventoryEntrySetInventoryLimitsAction.raml
@@ -0,0 +1,22 @@
+#%RAML 1.0 DataType
+(package): Inventory
+type: InventoryEntryUpdateAction
+displayName: InventoryEntrySetInventoryLimitsAction
+discriminatorValue: setInventoryLimits
+example: !include ../../../examples/Inventory/InventoryEntrySetInventoryLimitsAction.json
+description: |
+  Sets the inventory limits for a specific InventoryEntry. This action allows you to define minimum and maximum
+  quantities that can be added to a Cart. For more information, see [Quantity limits](/../api/carts-orders-overview#quantity-limits).
+properties:
+  minCartQuantity?:
+    type: number
+    format: int64
+    description: |
+      Sets the minimum quantity that can be added to a Cart. If the value is absent or `null`
+      the inventory limit is removed.
+  maxCartQuantity?:
+    type: number
+    format: int64
+    description: |
+      Sets the maximum quantity that can be added to a Cart. If the value is absent or `null`
+      the inventory limit is removed.
diff --git a/api-specs/api/types/me/updates/MyCartChangeLineItemQuantityAction.raml b/api-specs/api/types/me/updates/MyCartChangeLineItemQuantityAction.raml
@@ -18,6 +18,8 @@ description: |
   When the action applies to [LineItems](ctp:api:type:LineItem) with `ExternalTotal` [LineItemPriceMode](ctp:api:type:LineItemPriceMode),
   it will be changed to `ExternalPrice` and the existing `externalPrice` value, i.e. `LineItem.price`, will be retained.
   The LineItem total will be calculated by the system instead, so that the `externalTotalPrice` will be dropped.
+
+  This action is subject to [InventoryEntry](ctp:api:type:InventoryEntry) min/max restrictions when applicable. For more information, see [Quantity limits](/../api/carts-orders-overview#quantity-limits).
 properties:
   lineItemId?:
     type: string
diff --git a/api-specs/api/types/me/updates/MyCartSetLineItemSupplyChannelAction.raml b/api-specs/api/types/me/updates/MyCartSetLineItemSupplyChannelAction.raml
@@ -6,6 +6,8 @@ discriminatorValue: setLineItemSupplyChannel
 example: !include ../../../examples/Cart/CartSetLineItemSupplyChannelAction.json
 description: |
   Performing this action does not reserve stock. Stock is only reserved at Order creation if the [InventoryMode](ctp:api:type:InventoryMode) of the Cart is `TrackOnly` or `ReserveOnOrder`.
+
+  This action is subject to [InventoryEntry](ctp:api:type:InventoryEntry) min/max restrictions when applicable. For more information, see [Quantity limits](/../api/carts-orders-overview#quantity-limits).
 properties:
   lineItemId?:
     type: string
diff --git a/api-specs/api/types/types.raml b/api-specs/api/types/types.raml
@@ -758,6 +758,7 @@ InventoryEntryRemoveQuantityAction: !include inventory/updates/InventoryEntryRem
 InventoryEntrySetCustomFieldAction: !include inventory/updates/InventoryEntrySetCustomFieldAction.raml
 InventoryEntrySetCustomTypeAction: !include inventory/updates/InventoryEntrySetCustomTypeAction.raml
 InventoryEntrySetExpectedDeliveryAction: !include inventory/updates/InventoryEntrySetExpectedDeliveryAction.raml
+InventoryEntrySetInventoryLimitsAction: !include inventory/updates/InventoryEntrySetInventoryLimitsAction.raml
 InventoryEntrySetKeyAction: !include inventory/updates/InventoryEntrySetKeyAction.raml
 InventoryEntrySetRestockableInDaysAction: !include inventory/updates/InventoryEntrySetRestockableInDaysAction.raml
 InventoryEntrySetSupplyChannelAction: !include inventory/updates/InventoryEntrySetSupplyChannelAction.raml
diff --git a/api-specs/graphql/schema.sdl b/api-specs/graphql/schema.sdl
@@ -5233,6 +5233,8 @@ type InventoryEntry implements Versioned & ReferenceExpandable {
   supplyChannel: Channel
   expectedDelivery: DateTime
   supplyChannelRef: Reference
+  minCartQuantity: Long
+  maxCartQuantity: Long
   custom: CustomFieldsType
   id: String!
   version: Long!
@@ -5262,6 +5264,8 @@ input InventoryEntryDraft {
   expectedDelivery: DateTime
   supplyChannel: ResourceIdentifierInput
   custom: CustomFieldsDraft
+  minCartQuantity: Long
+  maxCartQuantity: Long
 }
 
 type InventoryEntryQuantitySet implements MessagePayload {
@@ -5286,11 +5290,13 @@ input InventoryEntryUpdateAction {
   addQuantity: AddInventoryEntryQuantity
   changeQuantity: ChangeInventoryEntryQuantity
   removeQuantity: RemoveInventoryEntryQuantity
+  setKey: SetInventoryKey
   setRestockableInDays: SetInventoryEntryRestockableInDays
   setExpectedDelivery: SetInventoryEntryExpectedDelivery
   setSupplyChannel: SetInventoryEntrySupplyChannel
   setCustomType: SetInventoryEntryCustomType
   setCustomField: SetInventoryEntryCustomField
+  setInventoryLimits: SetInventoryLimits
 }
 
 enum InventoryMode {
@@ -12527,6 +12533,15 @@ input SetInventoryEntrySupplyChannel {
   supplyChannel: ResourceIdentifierInput
 }
 
+input SetInventoryKey {
+  key: String
+}
+
+input SetInventoryLimits {
+  minCartQuantity: Int
+  maxCartQuantity: Int
+}
+
 "BETA: This feature can be subject to change and should be used carefully in production. https://docs.commercetools.com/api/contract#public-beta"
 input SetLineItemRecurrenceInfo {
   lineItemId: String!

Original file line number	Diff line number	Diff line change
`@@ -11,7 +11,9 @@`
`11`	`11`	`"quantityOnStock": 4,`
`12`	`12`	`"availableQuantity": 4,`
`13`	`13`	`"createdAt": "2015-03-11T13:36:20.720Z",`
`14`		`- "lastModifiedAt": "2015-03-11T13:36:20.720Z"`
	`14`	`+ "lastModifiedAt": "2015-03-11T13:36:20.720Z",`
	`15`	`+ "minCartQuantity": 2,`
	`16`	`+ "maxCartQuantity": 50`
`15`	`17`	`}`
`16`	`18`	`]`
`17`	`19`	`}`