---
title: "Update Inventory Hold"
method: POST
path: "/v1/integrations/inventory-hold/update"
tags: ["Inventory Holds"]
---

# Update Inventory Hold

`POST /v1/integrations/inventory-hold/update`

Replaces the products covered by an inventory hold created through `POST /v1/integrations/inventory-hold`, addressed by the `inventory_hold_uuid` that call returned.

## General description
- The `items` list is the desired state: products missing from it are released, new ones are added and the rest is left untouched.
- Just like creating a hold, this works only until the receiving starts being received.

## Request body

- ShipMonkPublicApiInventoryHoldInventoryHoldUpdateUpdateInventoryHoldInput
  - `inventory_hold_uuid` string, required — Identifier of the inventory hold to update, as returned when it was created.
  - `items` ShipMonkPublicApiInventoryHoldInventoryHoldItemInput[], required — Products the hold should cover from now on. The list replaces the current one, so items missing from it are released, new items are added and the rest is left untouched.
    - `sku` string, required — Stock Keeping Unit (SKU), the client's unique product code. Must match an active product of the account.
    - `lot` ShipMonkPublicApiInventoryHoldInventoryHoldItemLotInput
      - `lot_number` string, nullable — Supplier-assigned lot/batch number to hold. Pass null to hold every lot number of the product.
      - `expiration_date` string, date, nullable — Lot expiration date in ISO 8601 format (YYYY-MM-DD) to hold. Pass null to hold every expiration date of the product.

## Response `200`

Success

- ShipMonkOMSQuarantineApiResourcePublicApiInventoryHoldChangedOutput
  - `inventory_hold_uuid` string, required — Identifier of the inventory hold the call acted on.
  - `message` string, required — Human-readable message describing what happened to the inventory hold.

## Changes

- **2026-08-28** `9c1d10357491` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/shipmonk/apis/shipmonk-api/changes/v1/integrations/inventory-hold/update/post.md)

---

[API](https://skmtc.dev/shipmonk/apis/shipmonk-api.md) · [All operations](https://skmtc.dev/shipmonk/apis/shipmonk-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/shipmonk/shipmonk-api/revisions/9c1d10357491/schema)