---
title: "Changes to Update a Shipment"
method: PATCH
path: "/2024-09/shipments/{easyship_shipment_id}"
---

# Changes to Update a Shipment

`PATCH /2024-09/shipments/{easyship_shipment_id}`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 1 of 2 revisions.

- **2026-11-03** `b47b54b748a7`: 12 breaking, 36 info

## Changes

- **2026-11-03** `b47b54b748a7`: 12 breaking, 36 info
  - the request property `origin_address/allOf[#/components/schemas/Address]/contact_name` became not nullable
  - the request property `origin_address/allOf[#/components/schemas/Address]/state` became not nullable
  - the request property `return_address/allOf[#/components/schemas/Address]/contact_name` became not nullable
  - the request property `return_address/allOf[#/components/schemas/Address]/state` became not nullable
  - the request property `sender_address/allOf[#/components/schemas/Address]/contact_name` became not nullable
  - the request property `sender_address/allOf[#/components/schemas/Address]/state` became not nullable
  - the response property `shipment/origin_address/allOf[#/components/schemas/Address]/contact_phone` became nullable for the status `200`
  - the response property `shipment/origin_address/allOf[#/components/schemas/Address]/postal_code` became nullable for the status `200`
  - the response property `shipment/return_address/allOf[#/components/schemas/Address]/contact_phone` became nullable for the status `200`
  - the response property `shipment/return_address/allOf[#/components/schemas/Address]/postal_code` became nullable for the status `200`
  - the response property `shipment/sender_address/allOf[#/components/schemas/Address]/contact_phone` became nullable for the status `200`
  - the response property `shipment/sender_address/allOf[#/components/schemas/Address]/postal_code` became nullable for the status `200`
  - added the new optional request property `destination_address/allOf[#/components/schemas/DestinationAddress]/line_3`
  - added the new optional request property `origin_address/allOf[#/components/schemas/Address]/company_name`
  - added the new optional request property `origin_address/allOf[#/components/schemas/Address]/contact_email`
  - added the new optional request property `origin_address/allOf[#/components/schemas/Address]/country_alpha2`
  - added the new optional request property `origin_address/allOf[#/components/schemas/Address]/line_3`
  - added the new optional request property `return_address/allOf[#/components/schemas/Address]/company_name`
  - added the new optional request property `return_address/allOf[#/components/schemas/Address]/contact_email`
  - added the new optional request property `return_address/allOf[#/components/schemas/Address]/country_alpha2`
  - added the new optional request property `return_address/allOf[#/components/schemas/Address]/line_3`
  - added the new optional request property `sender_address/allOf[#/components/schemas/Address]/company_name`
  - added the new optional request property `sender_address/allOf[#/components/schemas/Address]/contact_email`
  - added the new optional request property `sender_address/allOf[#/components/schemas/Address]/country_alpha2`
  - added the new optional request property `sender_address/allOf[#/components/schemas/Address]/line_3`
  - added the new optional request property `shipping_settings/scheduled_ship_date`
  - the request property `origin_address/allOf[#/components/schemas/Address]/contact_phone` became nullable
  - the request property `origin_address/allOf[#/components/schemas/Address]/postal_code` became nullable
  - the request property `return_address/allOf[#/components/schemas/Address]/contact_phone` became nullable
  - the request property `return_address/allOf[#/components/schemas/Address]/postal_code` became nullable
  - the request property `sender_address/allOf[#/components/schemas/Address]/contact_phone` became nullable
  - the request property `sender_address/allOf[#/components/schemas/Address]/postal_code` became nullable
  - added the optional property `shipment/destination_address/line_3` to the response with the `200` status
  - added the optional property `shipment/origin_address/allOf[#/components/schemas/Address]/company_name` to the response with the `200` status
  - added the optional property `shipment/origin_address/allOf[#/components/schemas/Address]/contact_email` to the response with the `200` status
  - added the optional property `shipment/origin_address/allOf[#/components/schemas/Address]/country_alpha2` to the response with the `200` status
  - added the optional property `shipment/origin_address/allOf[#/components/schemas/Address]/line_3` to the response with the `200` status
  - added the optional property `shipment/rates/items/courier_service/icon` to the response with the `200` status
  - added the optional property `shipment/return_address/allOf[#/components/schemas/Address]/company_name` to the response with the `200` status
  - added the optional property `shipment/return_address/allOf[#/components/schemas/Address]/contact_email` to the response with the `200` status
  - …8 more

---

[Operation](https://skmtc.dev/easyship/apis/easyship-public-api/docs/2024-09/shipments/:easyship_shipment_id/patch.md) - [API](https://skmtc.dev/easyship/apis/easyship-public-api.md) - [Page](https://skmtc.dev/easyship/apis/easyship-public-api/changes/2024-09/shipments/:easyship_shipment_id/patch)