--- title: "Changes to Update shipment by ID" method: PUT path: "/v1/shipments/{shipment_id}" --- # Changes to Update shipment by ID `PUT /v1/shipments/{shipment_id}` > Every recorded change to this operation, newest first. ## Timeline Changed in 9 of 24 revisions. - **2026-10-22** `e998dffc42be`: 9 warning, 2 info - **2026-10-09** `020f57d6f5b8`: 58 breaking, 57 warning, 159 info - **2026-09-09** `a53b77a09f4a`: 1 info - **2026-09-06** `3fdd35fbad5c`: 3 warning - **2026-09-04** `0ea4426bd2c9`: 2 info - **2026-09-03** `af7218990159`: 2 info - **2026-09-02** `45d27f8700ae`: 2 info - **2026-08-19** `3a3a81a22d2f`: 1 warning, 1 info - **2026-08-15** `f3a66d204565`: 18 warning ## Changes - **2026-10-22** `e998dffc42be`: 9 warning, 2 info - added the new `bring_your_own_label_not_supported` enum value to the `errors/items/error_code` response property for the response status `400` - added the new `bring_your_own_label_not_supported` enum value to the `errors/items/error_code` response property for the response status `404` - added the new `bring_your_own_label_not_supported` enum value to the `errors/items/error_code` response property for the response status `500` - added the new `multiple_sales_orders` enum value to the `errors/items/error_code` response property for the response status `400` - added the new `multiple_sales_orders` enum value to the `errors/items/error_code` response property for the response status `404` - added the new `multiple_sales_orders` enum value to the `errors/items/error_code` response property for the response status `500` - added the new `sales_order_link_required` enum value to the `errors/items/error_code` response property for the response status `400` - added the new `sales_order_link_required` enum value to the `errors/items/error_code` response property for the response status `404` - added the new `sales_order_link_required` enum value to the `errors/items/error_code` response property for the response status `500` - added the new optional request property `allOf[subschema #1: partial_shipment]/items/items/item_id` - added the optional property `allOf[subschema #1: create_and_validate_shipment]/allOf[subschema #1: partial_shipment]/items/items/item_id` to the response with the `200` status - **2026-10-09** `020f57d6f5b8`: 58 breaking, 57 warning, 159 info - added the new required request property `allOf[subschema #1: partial_shipment]/customs/allOf[subschema #1: international_shipment_options]/importer_of_record/address_line1` - added the new required request property `allOf[subschema #1: partial_shipment]/customs/allOf[subschema #1: international_shipment_options]/importer_of_record/city_locality` - added the new required request property `allOf[subschema #1: partial_shipment]/customs/allOf[subschema #1: international_shipment_options]/importer_of_record/country_code` - added the new required request property `allOf[subschema #1: partial_shipment]/customs/allOf[subschema #1: international_shipment_options]/importer_of_record/name` - added the new required request property `allOf[subschema #1: partial_shipment]/customs/allOf[subschema #1: international_shipment_options]/importer_of_record/postal_code` - added the new required request property `allOf[subschema #1: partial_shipment]/packages/items/weight` - added the new required request property `allOf[subschema #1: partial_shipment]/tags/items/name` - added the new required request property `allOf[subschema #1: partial_shipment]/tax_identifiers/items/identifier_type` - added the new required request property `allOf[subschema #1: partial_shipment]/tax_identifiers/items/issuing_authority` - added the new required request property `allOf[subschema #1: partial_shipment]/tax_identifiers/items/taxable_entity_type` - added the new required request property `allOf[subschema #1: partial_shipment]/tax_identifiers/items/value` - request property `allOf[subschema #1: partial_shipment]/advanced_options/allOf[subschema #1: advanced_shipment_options]/collect_on_delivery/payment_type` was restricted to a list of enum values - request property `allOf[subschema #1: partial_shipment]/advanced_options/allOf[subschema #1: advanced_shipment_options]/dry_ice_weight/allOf[subschema #1: weight]/unit` was restricted to a list of enum values - request property `allOf[subschema #1: partial_shipment]/customs/allOf[subschema #1: international_shipment_options]/customs_items/items/weight/allOf[subschema #1: weight]/unit` was restricted to a list of enum values - request property `allOf[subschema #1: partial_shipment]/order_source_code` was restricted to a list of enum values - request property `allOf[subschema #1: partial_shipment]/total_weight/allOf[subschema #1: weight]/unit` was restricted to a list of enum values - the `allOf[subschema #1: partial_shipment]/batch_ids/items/` request property's minLength was increased from `0` to `1` - the `allOf[subschema #1: partial_shipment]/return_to/allOf[subschema #1: shipping_address]/allOf[subschema #1: address]/allOf[subschema #1: partial_address]/postal_code` request property's minLength was increased from `0` to `1` - the `allOf[subschema #1: partial_shipment]/ship_from/allOf[subschema #1: shipping_address]/allOf[subschema #1: address]/allOf[subschema #1: partial_address]/postal_code` request property's minLength was increased from `0` to `1` - the `allOf[subschema #1: partial_shipment]/ship_to/allOf[subschema #1: shipping_address_to]/allOf[subschema #1: address]/allOf[subschema #1: partial_address]/postal_code` request property's minLength was increased from `0` to `1` - added the pattern `^se(-[a-z0-9]+)+$` to the request property `allOf[subschema #1: partial_shipment]/batch_ids/items/` - the `allOf[subschema #1: partial_shipment]/advanced_options/allOf[subschema #1: advanced_shipment_options]/collect_on_delivery/payment_amount/currency` request property type changed from no type to `string` - the `allOf[subschema #1: partial_shipment]/advanced_options/allOf[subschema #1: advanced_shipment_options]/collect_on_delivery/payment_type` request property type changed from no type to `string` - the `allOf[subschema #1: partial_shipment]/advanced_options/allOf[subschema #1: advanced_shipment_options]/dry_ice_weight/allOf[subschema #1: weight]/unit` request property type changed from no type to `string` - the `allOf[subschema #1: partial_shipment]/batch_ids/items/` request property type changed from no type to `string` - the `allOf[subschema #1: partial_shipment]/customs/allOf[subschema #1: international_shipment_options]/customs_items/items/weight/allOf[subschema #1: weight]/unit` request property type changed from no type to `string` - the `allOf[subschema #1: partial_shipment]/customs/allOf[subschema #1: international_shipment_options]/importer_of_record` request property type changed from no type to `object` - the `allOf[subschema #1: partial_shipment]/customs/allOf[subschema #1: international_shipment_options]/invoice_additional_details` request property type changed from no type to `object` - the `allOf[subschema #1: partial_shipment]/items/items/` request property type changed from no type to `object` - the `allOf[subschema #1: partial_shipment]/order_source_code` request property type changed from no type to `string` - the `allOf[subschema #1: partial_shipment]/packages/items/` request property type changed from no type to `object` - the `allOf[subschema #1: partial_shipment]/return_to/allOf[subschema #1: shipping_address]/allOf[subschema #1: address]/allOf[subschema #1: partial_address]/postal_code` request property type changed from no type to `string` - the `allOf[subschema #1: partial_shipment]/ship_from/allOf[subschema #1: shipping_address]/allOf[subschema #1: address]/allOf[subschema #1: partial_address]/postal_code` request property type changed from no type to `string` - the `allOf[subschema #1: partial_shipment]/ship_to/allOf[subschema #1: shipping_address_to]/allOf[subschema #1: address]/allOf[subschema #1: partial_address]/postal_code` request property type changed from no type to `string` - the `allOf[subschema #1: partial_shipment]/tags/items/` request property type changed from no type to `object` - the `allOf[subschema #1: partial_shipment]/tax_identifiers/items/` request property type changed from no type to `object` - the `allOf[subschema #1: partial_shipment]/total_weight/allOf[subschema #1: weight]/unit` request property type changed from no type to `string` - the `allOf[subschema #1: create_and_validate_shipment]/allOf[subschema #1: partial_shipment]/advanced_options/allOf[subschema #1: advanced_shipment_options]/collect_on_delivery/payment_amount/currency` response's property type changed from no type to `string` for status `200` - the `allOf[subschema #1: create_and_validate_shipment]/allOf[subschema #1: partial_shipment]/advanced_options/allOf[subschema #1: advanced_shipment_options]/collect_on_delivery/payment_type` response's property type changed from no type to `string` for status `200` - the `allOf[subschema #1: create_and_validate_shipment]/allOf[subschema #1: partial_shipment]/advanced_options/allOf[subschema #1: advanced_shipment_options]/dry_ice_weight/allOf[subschema #1: weight]/unit` response's property type changed from no type to `string` for status `200` - …234 more - **2026-09-09** `a53b77a09f4a`: 1 info - added the optional property `allOf[subschema #1: create_and_validate_shipment]/allOf[subschema #1: partial_shipment]/batch_ids` to the response with the `200` status - **2026-09-06** `3fdd35fbad5c`: 3 warning - added the new `freight_provider_already_connected` enum value to the `errors/items/allOf[subschema #1: error]/error_code/allOf[subschema #1: error_code]/` response property for the response status `400` - added the new `freight_provider_already_connected` enum value to the `errors/items/allOf[subschema #1: error]/error_code/allOf[subschema #1: error_code]/` response property for the response status `404` - added the new `freight_provider_already_connected` enum value to the `errors/items/allOf[subschema #1: error]/error_code/allOf[subschema #1: error_code]/` response property for the response status `500` - **2026-09-04** `0ea4426bd2c9`: 2 info - added the new optional request property `allOf[subschema #1: partial_shipment]/advanced_options/allOf[subschema #1: advanced_shipment_options]/suppress_carrier_generated_documents` - added the optional property `allOf[subschema #1: create_and_validate_shipment]/allOf[subschema #1: partial_shipment]/advanced_options/allOf[subschema #1: advanced_shipment_options]/suppress_carrier_generated_documents` to the response with the `200` status - **2026-09-03** `af7218990159`: 2 info - added the new optional request property `allOf[subschema #1: partial_shipment]/advanced_options/allOf[subschema #1: advanced_shipment_options]/transparency_codes` - added the optional property `allOf[subschema #1: create_and_validate_shipment]/allOf[subschema #1: partial_shipment]/advanced_options/allOf[subschema #1: advanced_shipment_options]/transparency_codes` to the response with the `200` status - **2026-09-02** `45d27f8700ae`: 2 info - added the new optional request property `allOf[subschema #1: partial_shipment]/packages/items/allOf[subschema #1: package]/products/items/cpsc_disclaim` - added the optional property `allOf[subschema #1: create_and_validate_shipment]/allOf[subschema #1: partial_shipment]/packages/items/allOf[subschema #1: package]/products/items/cpsc_disclaim` to the response with the `200` status - **2026-08-19** `3a3a81a22d2f`: 1 warning, 1 info - added the new `adult_signature_restricted_delivery` enum value to the `allOf[subschema #1: create_and_validate_shipment]/allOf[subschema #1: partial_shipment]/confirmation/allOf[subschema #1: delivery_confirmation]/` response property for the response status `200` - added the new `adult_signature_restricted_delivery` enum value to the request property `allOf[subschema #1: partial_shipment]/confirmation/allOf[subschema #1: delivery_confirmation]/` - **2026-08-15** `f3a66d204565`: 18 warning - added the new `freight_connection_inactive` enum value to the `errors/items/allOf[subschema #1: error]/error_code/allOf[subschema #1: error_code]/` response property for the response status `400` - added the new `freight_connection_inactive` enum value to the `errors/items/allOf[subschema #1: error]/error_code/allOf[subschema #1: error_code]/` response property for the response status `404` - added the new `freight_connection_inactive` enum value to the `errors/items/allOf[subschema #1: error]/error_code/allOf[subschema #1: error_code]/` response property for the response status `500` - added the new `freight_provider_id_required` enum value to the `errors/items/allOf[subschema #1: error]/error_code/allOf[subschema #1: error_code]/` response property for the response status `400` - added the new `freight_provider_id_required` enum value to the `errors/items/allOf[subschema #1: error]/error_code/allOf[subschema #1: error_code]/` response property for the response status `404` - added the new `freight_provider_id_required` enum value to the `errors/items/allOf[subschema #1: error]/error_code/allOf[subschema #1: error_code]/` response property for the response status `500` - added the new `freight_shipment_not_batchable` enum value to the `errors/items/allOf[subschema #1: error]/error_code/allOf[subschema #1: error_code]/` response property for the response status `400` - added the new `freight_shipment_not_batchable` enum value to the `errors/items/allOf[subschema #1: error]/error_code/allOf[subschema #1: error_code]/` response property for the response status `404` - added the new `freight_shipment_not_batchable` enum value to the `errors/items/allOf[subschema #1: error]/error_code/allOf[subschema #1: error_code]/` response property for the response status `500` - added the new `freight_shipment_not_found` enum value to the `errors/items/allOf[subschema #1: error]/error_code/allOf[subschema #1: error_code]/` response property for the response status `400` - added the new `freight_shipment_not_found` enum value to the `errors/items/allOf[subschema #1: error]/error_code/allOf[subschema #1: error_code]/` response property for the response status `404` - added the new `freight_shipment_not_found` enum value to the `errors/items/allOf[subschema #1: error]/error_code/allOf[subschema #1: error_code]/` response property for the response status `500` - added the new `freight_tracking_not_available` enum value to the `errors/items/allOf[subschema #1: error]/error_code/allOf[subschema #1: error_code]/` response property for the response status `400` - added the new `freight_tracking_not_available` enum value to the `errors/items/allOf[subschema #1: error]/error_code/allOf[subschema #1: error_code]/` response property for the response status `404` - added the new `freight_tracking_not_available` enum value to the `errors/items/allOf[subschema #1: error]/error_code/allOf[subschema #1: error_code]/` response property for the response status `500` - added the new `freight_tracking_not_found` enum value to the `errors/items/allOf[subschema #1: error]/error_code/allOf[subschema #1: error_code]/` response property for the response status `400` - added the new `freight_tracking_not_found` enum value to the `errors/items/allOf[subschema #1: error]/error_code/allOf[subschema #1: error_code]/` response property for the response status `404` - added the new `freight_tracking_not_found` enum value to the `errors/items/allOf[subschema #1: error]/error_code/allOf[subschema #1: error_code]/` response property for the response status `500` --- [Operation](https://skmtc.dev/shipstation/apis/shipengine-api/docs/v1/shipments/:shipment_id/put.md) - [API](https://skmtc.dev/shipstation/apis/shipengine-api.md) - [Page](https://skmtc.dev/shipstation/apis/shipengine-api/changes/v1/shipments/:shipment_id/put)