---
title: "Changes to Update a parcel"
method: PATCH
path: "/parcels/{parcelId}"
---

# Changes to Update a parcel

`PATCH /parcels/{parcelId}`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 1 of 11 revisions.

- **2026-07-13** `859097ed3fe6`: 5 breaking, 4 warning, 29 info

## Changes

- **2026-07-13** `859097ed3fe6`: 5 breaking, 4 warning, 29 info
  - added the new required request property `data/relationships/package/data`
  - added the new required request property `data/relationships/shipment/data`
  - request property `data/attributes/unit_of_weight` was restricted to a list of enum values
  - request property `data/type` was restricted to a list of enum values
  - the `data/attributes/tracking_details` request property type changed from `string` to `array, null`
  - removed the request property `data/relationships/package/id`
  - removed the request property `data/relationships/package/type`
  - removed the request property `data/relationships/shipment/id`
  - removed the request property `data/relationships/shipment/type`
  - added the new optional request property `data/attributes/delivery_confirmation`
  - added the new optional request property `data/attributes/shipping_label_file_type`
  - added the new optional request property `data/attributes/shipping_label_resolution`
  - added the new optional request property `data/attributes/shipping_label_size`
  - added the new optional request property `data/attributes/shipping_label_url`
  - the request property `data/attributes/carrier_weight_oz` became nullable
  - the request property `data/attributes/contents_explanation` became nullable
  - the request property `data/attributes/contents_type` became nullable
  - the request property `data/attributes/customs_signer` became nullable
  - the request property `data/attributes/eel_pfc` became nullable
  - the request property `data/attributes/incoterm` became nullable
  - the request property `data/attributes/metadata` became nullable
  - the request property `data/attributes/non_delivery_option` became nullable
  - the request property `data/attributes/reference` became nullable
  - the request property `data/attributes/reference_origin` became nullable
  - the request property `data/attributes/restriction_comments` became nullable
  - the request property `data/attributes/restriction_type` became nullable
  - the request property `data/attributes/signed_by` became nullable
  - the request property `data/attributes/tracking_details` became nullable
  - the request property `data/attributes/tracking_number` became nullable
  - the request property `data/attributes/tracking_status` became nullable
  - the request property `data/attributes/tracking_status_detail` became nullable
  - the request property `data/attributes/tracking_status_updated_at` became nullable
  - the `type` request property default value `parcels` was removed
  - added the new `gr` enum value to the request property `data/attributes/unit_of_weight`
  - added the new `lb` enum value to the request property `data/attributes/unit_of_weight`
  - added the new `oz` enum value to the request property `data/attributes/unit_of_weight`
  - added the new `parcels` 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/parcels/:parcelId/patch.md) - [API](https://skmtc.dev/commercelayer/apis/commerce-layer-api.md) - [Page](https://skmtc.dev/commercelayer/apis/commerce-layer-api/changes/parcels/:parcelId/patch)