---
title: "Changes to Update a shipment draft"
method: PUT
path: "/shipment_drafts/{id}"
---

# Changes to Update a shipment draft

`PUT /shipment_drafts/{id}`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 3 of 17 revisions.

- **2026-09-11** `597a3e53ac0d`: 2 info
- **2026-08-21** `3b9f91693dec`: 6 breaking, 6 info
- **2026-08-21** `ad86900cf9c2`: 3 breaking, 12 warning, 1 info

## Changes

- **2026-09-11** `597a3e53ac0d`: 2 info
  - added the new optional request property `allOf[#/components/schemas/ShipmentDraft]/parties/items/state`
  - added the optional property `allOf[#/components/schemas/ShipmentDraft]/parties/items/state` to the response with the `200` status
- **2026-08-21** `3b9f91693dec`: 6 breaking, 6 info
  - the response property `allOf[#/components/schemas/ShipmentDraft]/parcels/items/allOf[#/components/schemas/ShipmentDraftParcel]/declared_value/amount` became nullable for the status `200`
  - the response property `allOf[#/components/schemas/ShipmentDraft]/parcels/items/allOf[#/components/schemas/ShipmentDraftParcel]/declared_value/currency_code` became nullable for the status `200`
  - the response property `allOf[#/components/schemas/ShipmentDraft]/parties/items/address2` became nullable for the status `200`
  - the response property `allOf[#/components/schemas/ShipmentDraft]/parties/items/attention` became nullable for the status `200`
  - the response property `allOf[#/components/schemas/ShipmentDraft]/parties/items/email` became nullable for the status `200`
  - the response property `allOf[#/components/schemas/ShipmentDraft]/parties/items/phone` became nullable for the status `200`
  - the request property `allOf[#/components/schemas/ShipmentDraft]/parcels/items/allOf[#/components/schemas/ShipmentDraftParcel]/declared_value/amount` became nullable
  - the request property `allOf[#/components/schemas/ShipmentDraft]/parcels/items/allOf[#/components/schemas/ShipmentDraftParcel]/declared_value/currency_code` became nullable
  - the request property `allOf[#/components/schemas/ShipmentDraft]/parties/items/address2` became nullable
  - the request property `allOf[#/components/schemas/ShipmentDraft]/parties/items/attention` became nullable
  - the request property `allOf[#/components/schemas/ShipmentDraft]/parties/items/email` became nullable
  - the request property `allOf[#/components/schemas/ShipmentDraft]/parties/items/phone` became nullable
- **2026-08-21** `ad86900cf9c2`: 3 breaking, 12 warning, 1 info
  - added `#/components/schemas/ShipmentDraftCustoms` to the `allOf[#/components/schemas/ShipmentDraft]/customs` request property `allOf` list
  - the `allOf[#/components/schemas/ShipmentDraft]/customs` request property type changed from `object` to no type
  - the `allOf[#/components/schemas/ShipmentDraft]/customs` response's property type changed from `object` to no type for status `200`
  - removed the request property `allOf[#/components/schemas/ShipmentDraft]/customs/attributes`
  - removed the request property `allOf[#/components/schemas/ShipmentDraft]/customs/currency_code`
  - removed the request property `allOf[#/components/schemas/ShipmentDraft]/customs/export_reason`
  - removed the request property `allOf[#/components/schemas/ShipmentDraft]/customs/freight_cost`
  - removed the request property `allOf[#/components/schemas/ShipmentDraft]/customs/goods`
  - removed the request property `allOf[#/components/schemas/ShipmentDraft]/customs/insurance_cost`
  - removed the optional property `allOf[#/components/schemas/ShipmentDraft]/customs/attributes` from the response with the `200` status
  - removed the optional property `allOf[#/components/schemas/ShipmentDraft]/customs/currency_code` from the response with the `200` status
  - removed the optional property `allOf[#/components/schemas/ShipmentDraft]/customs/export_reason` from the response with the `200` status
  - removed the optional property `allOf[#/components/schemas/ShipmentDraft]/customs/freight_cost` from the response with the `200` status
  - removed the optional property `allOf[#/components/schemas/ShipmentDraft]/customs/goods` from the response with the `200` status
  - removed the optional property `allOf[#/components/schemas/ShipmentDraft]/customs/insurance_cost` from the response with the `200` status
  - added `#/components/schemas/ShipmentDraftCustoms` to the `allOf[#/components/schemas/ShipmentDraft]/customs` response property `allOf` list for the response status `200`

---

[Operation](https://skmtc.dev/shipmondo/apis/shipmondo-api/docs/shipment_drafts/:id/put.md) - [API](https://skmtc.dev/shipmondo/apis/shipmondo-api.md) - [Page](https://skmtc.dev/shipmondo/apis/shipmondo-api/changes/shipment_drafts/:id/put)