---
title: "Changes to Update a shipment"
method: PATCH
path: "/shipments/{shipmentId}"
---

# Changes to Update a shipment

`PATCH /shipments/{shipmentId}`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 2 of 11 revisions.

- **2026-10-13** `7626ac743941`: 1 info
- **2026-07-13** `859097ed3fe6`: 2 breaking, 2 warning, 20 info

## Changes

- **2026-10-13** `7626ac743941`: 1 info
  - added the optional property `data/attributes/store_shipment_policy` to the response with the `200` status
- **2026-07-13** `859097ed3fe6`: 2 breaking, 2 warning, 20 info
  - added the new required request property `data/relationships/shipping_method/data`
  - request property `data/type` was restricted to a list of enum values
  - removed the request property `data/relationships/shipping_method/id`
  - removed the request property `data/relationships/shipping_method/type`
  - added the new optional request property `data/attributes/_add_tags`
  - added the new optional request property `data/attributes/_cancel`
  - added the new optional request property `data/attributes/_decrement_stock`
  - added the new optional request property `data/attributes/_deliver`
  - added the new optional request property `data/attributes/_release_stock`
  - added the new optional request property `data/attributes/_remove_tags`
  - added the new optional request property `data/attributes/_reserve_stock`
  - added the new optional request property `data/attributes/_upcoming`
  - added the new optional request property `data/attributes/number`
  - added the new optional request property `data/relationships/inventory_stock_location`
  - added the new optional request property `data/relationships/shipping_address`
  - added the new optional request property `data/relationships/shipping_category`
  - added the new optional request property `data/relationships/tags`
  - the request property `data/attributes/metadata` became nullable
  - the request property `data/attributes/reference` became nullable
  - the request property `data/attributes/reference_origin` became nullable
  - the request property `data/attributes/selected_rate_id` became nullable
  - the `type` request property default value `shipments` was removed
  - added the new `shipments` enum value to the request property `data/type`
  - added the media type `application/vnd.api+json` for the response with the status `200`

---

[Operation](https://skmtc.dev/commercelayer/apis/commerce-layer-api/docs/shipments/:shipmentId/patch.md) - [API](https://skmtc.dev/commercelayer/apis/commerce-layer-api.md) - [Page](https://skmtc.dev/commercelayer/apis/commerce-layer-api/changes/shipments/:shipmentId/patch)