Skip to main content

Update Quantity

POST 
/api/items/updateqty

Tier: Public — stable, supported for third-party integration.

Updates the quantity of an item addressed by id or by tag number.

To address the item by tag number, UpdateItemQuantityDto.ItemId must be sent as the all-zero GUID (00000000-0000-0000-0000-000000000000) rather than omitted or left null — an omitted/null ItemId is rejected with HTTP 400. Because the controller then re-fetches using the id branch with an all-zero GUID, the response body for a successful tag-addressed update is null.

Validation by Enums.SkuType: Standard requires quantity 1 and multiplier 1; Kanban requires the multiplier to equal the SKU's lower or upper bound; VariablePercent requires the multiplier to be within the SKU's bounds; VariableQuantity requires the multiplier to be 1. Quantity must be non-negative in all cases. A successful update adjusts the item's SkuPlaceStock.

Request​

Responses​

Returns the updated item. See Items.ItemDetailDto. When addressing by tag (see remarks), this endpoint returns HTTP 200 with a null body even though the update succeeded.