---
title: "UpdateInventoryItem"
method: POST
path: "/api/Inventory/UpdateInventoryItem"
tags: ["Inventory"]
---

# UpdateInventoryItem

`POST /api/Inventory/UpdateInventoryItem`

Use this call to update stock items. This acts as a set endpoint, all data for the stock item will be replaced, even if not provided in the request.
The only exception is StockItemId. If left empty, the item to update will be identified by ItemNumber.
<b>Permissions Required: </b> GlobalPermissions.Inventory.Stock.StockWrite.ChangeStockItemDetailsNode
<b>Rate limit: </b><span style="background-color:#0272d9;color:white;padding:4px 8px;text-align:center;border-radius:5px; font-size: small;"><b>250</b></span> / minute

## Request body

- InventoryUpdateInventoryItemRequest
  - `inventoryItem` UpdateInventoryItemRequest
    - `VariationGroupName` string — Variation parent group name
    - `StockItemId` string, uuid — Stock Item Id. If not provided, it will be retrieved using the Item Number
    - `ItemDescription` string — Item Description(Metadata)
    - `Quantity` integer — Quantity in stock
    - `InOrder` integer — Quantity in order book
    - `Due` integer — Quantity due in purchase orders
    - `MinimumLevel` integer — Minimum level of stock item. -1 is not tracked. Null value when adding will use user default minimum level
    - `Available` integer — Available level. Quantity - InOrder
    - `IsCompositeParent` boolean — Item is a composite parent
    - `ShippedSeparately` boolean
    - `ItemNumber` string — SKU
    - `ItemTitle` string — Item title
    - `BarcodeNumber` string — Barcode number
    - `MetaData` string — Item description
    - `IsVariationParent` boolean — Is Variation Parent
    - `isBatchedStockType` boolean — Returns true is the stock item is tracked by batch
    - `PurchasePrice` number, double — Default item purchase price
    - `RetailPrice` number, double — Default item retail price
    - `TaxRate` number, double — Default item tax rate. Set -1 to use country tax rate
    - `PostalServiceId` string, uuid — Default postal service id
    - `PostalServiceName` string — Default postal service name
    - `CategoryId` string, uuid — Default category id
    - `CategoryName` string — Default category name
    - `PackageGroupId` string, uuid — Default package group id
    - `PackageGroupName` string — Default package group name
    - `Height` number, double — Item height
    - `Width` number, double — Item width
    - `Depth` number, double — Item depth
    - `Weight` number, double — Item weight
    - `CreationDate` string, date-time — Stock item creation date
    - `InventoryTrackingType` integer — Stock item tracking type. 0 = none. 1 = Ordered by Sell by Date. 2 = Ordered by Priority Sequence
    - `BatchNumberScanRequired` boolean — User must scan batch number when procesing orders
    - `SerialNumberScanRequired` boolean — User must scan item serial number when processing ordesr
    - `StockItemIntId` integer — Stock Item interger Id

## Response `204`

No Content

---

[API](https://skmtc.net/linnworks/apis/authenticate-api.md) · [All operations](https://skmtc.net/linnworks/apis/authenticate-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/linnworks/authenticate-api/versions/0123569a22fb/schema)