---
title: "Update a stock item"
method: PATCH
path: "/v1/stockItems/{stockItemId}"
tags: ["Stock"]
---

# Update a stock item

`PATCH /v1/stockItems/{stockItemId}`

Updates the details of a single stock item (required scope stock:write)

## Path parameters

- `stockItemId` integer, required

## Headers

- `Customer-Id` integer, required

## Request body

- UpdateStockItemModel — Represents a model for updating a stock item
  - `quantity` number, double, nullable — The quantity of the stock items. Must be omitted or null if the stock item is not consumable<br/><br/>Optional: Omit to retain current value or provide null to unset
  - `locationContactId` integer, nullable — The ID of the contact associated with the stock item, must be omitted or null if the stock item is located at a vehicle or another stock item<br/><br/>Optional: Omit to retain current value or provide null to unset
  - `locationVehicleId` integer, nullable — The ID of the vehicle associated with the stock item, must be omitted or null if the stock item is located at a contact or another stock item<br/><br/>Optional: Omit to retain current value or provide null to unset
  - `locationStockItemId` integer, nullable — The ID of the stock item this stock item is allocated to, must be omitted or null if the stock item is located at a contact or a vehicle<br/><br/>Optional: Omit to retain current value or provide null to unset
  - `soldAt` string, date-time, nullable — The date when the stock item was sold<br/><br/>Optional: Omit to retain current value or provide null to unset
  - `notes` string, nullable — Notes on the stock item, must be null or omitted if the stock item is consumable<br/><br/>Optional: Omit to retain current value or provide null to unset
  - `serialNumber` string, nullable — The unique number or barcode assigned to each individual stock item for identification and tracking. Required if the stock item is non consumable, otherwise must be null or omitted. Cannot contain preceding or trailing whitespace<br/><br/>Optional: Omit to retain current value or provide null to unset
  - `altSerialNumber` string, nullable — The alternative serial number of the stock item. Must be omitted or null if the stock item is consumable<br/><br/>Optional: Omit to retain current value or provide null to unset
  - `supplierSerialNumber` string, nullable — The unique number used by the supplier for the stock item. Must be omitted or null if the stock item is consumable<br/><br/>Optional: Omit to retain current value or provide null to unset
  - `customerSerialNumber` string, nullable — The unique number used by the customer for the stock item. Must be omitted or null if the stock item is consumable<br/><br/>Optional: Omit to retain current value or provide null to unset
  - `isEquipment` boolean — Indicates whether the stock item is equipment or not<br/><br/>Optional: Omit to retain current value
  - `condition` 'new' | 'refurbished' | 'used' — Represents the condition of a stock item<p>Possible values:</p><ul><li><b>new</b>: New stock item</li><li><b>refurbished</b>: Refurbished stock item</li><li><b>used</b>: Used stock item</li></ul>
  - `usage` number, double, nullable — The usage of the stock item. For items which are chargeable on an hourly, daily or weekly rate. Must be null or omitted if the stock item is consumable<br/><br/>Optional: Omit to retain current value or provide null to unset
  - `customFields` CustomFieldWriteModel[] — The custom fields associated with the stock item<br/><br/>Optional: Omit to retain current value
    - `definitionId` integer, required — The unique identifier of the associated custom field definition
    - `value` string, nullable — The value of this custom field. If set to null, any existing value will be unset

## Response `204`

No Content

## Other responses

- `400` — Bad Request
- `403` — Forbidden
- `404` — Not Found
- `422` — Unprocessable Content
- `500` — Internal Server Error

---

[API](https://skmtc.net/bigchange/apis/bigchange-dx.md) · [All operations](https://skmtc.net/bigchange/apis/bigchange-dx/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/bigchange/bigchange-dx/revisions/916e669fc527/schema)