--- title: "Changes to Purchase label with shipment id" method: POST path: "/v2/labels/shipment/{shipment_id}" --- # Changes to Purchase label with shipment id `POST /v2/labels/shipment/{shipment_id}` > Every recorded change to this operation, newest first. ## Timeline Changed in 13 of 30 revisions. - **2026-10-22** `4e29670aa28d`: 6 warning, 1 info - **2026-10-16** `bf3618aaf7e1`: 131 breaking, 21 info - **2026-10-13** `5bf6dc8ed400`: 1 breaking, 1 info - **2026-10-09** `934f5935dbea`: 20 breaking, 26 warning, 82 info - **2026-09-24** `2d228135b6f1`: 1 breaking, 6 warning, 1 info - **2026-09-10** `41bf3a6debc7`: 1 warning - **2026-09-09** `dc74a6387377`: 2 info - **2026-09-05** `17802d3fbe61`: 2 warning - **2026-09-04** `03ca91027c15`: 1 info - **2026-09-03** `cc0116dfedb6`: 1 info - **2026-09-02** `0e61ae174690`: 1 info - **2026-08-19** `13c58f90de0b`: 2 warning - **2026-08-15** `e9b68942091c`: 12 warning ## Changes - **2026-10-22** `4e29670aa28d`: 6 warning, 1 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 `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 `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 `subschema #2: shipment_sales_order_fields` to the `allOf[subschema #1: label]/shipment/allOf[subschema #1: shipment]/` response property `allOf` list for the response status `200` - **2026-10-16** `bf3618aaf7e1`: 131 breaking, 21 info - the response property `allOf[subschema #1: label]/alternative_identifiers` became nullable for the status `200` - the response property `allOf[subschema #1: label]/external_order_id` became nullable for the status `200` - the response property `allOf[subschema #1: label]/external_shipment_id` became nullable for the status `200` - the response property `allOf[subschema #1: label]/packages/items/allOf[subschema #1: label_package]/content_description` became nullable for the status `200` - the response property `allOf[subschema #1: label]/packages/items/allOf[subschema #1: label_package]/label_messages/reference1` became nullable for the status `200` - the response property `allOf[subschema #1: label]/packages/items/allOf[subschema #1: label_package]/label_messages/reference2` became nullable for the status `200` - the response property `allOf[subschema #1: label]/packages/items/allOf[subschema #1: label_package]/label_messages/reference3` became nullable for the status `200` - the response property `allOf[subschema #1: label]/packages/items/allOf[subschema #1: label_package]/paperless_download/allOf[subschema #1: paperless_download]/handoff_code` became nullable for the status `200` - the response property `allOf[subschema #1: label]/packages/items/allOf[subschema #1: label_package]/paperless_download/allOf[subschema #1: paperless_download]/instructions` became nullable for the status `200` - the response property `allOf[subschema #1: label]/packages/items/allOf[subschema #2: alternative_identifiers]/alternative_identifiers` became nullable for the status `200` - the response property `allOf[subschema #1: label]/rma_number` became nullable for the status `200` - the response property `allOf[subschema #1: label]/ship_to/allOf[subschema #1: shipping_address_to]/allOf[subschema #1: address]/allOf[subschema #1: partial_address]/address_line2` became nullable for the status `200` - the response property `allOf[subschema #1: label]/ship_to/allOf[subschema #1: shipping_address_to]/allOf[subschema #1: address]/allOf[subschema #1: partial_address]/address_line3` became nullable for the status `200` - the response property `allOf[subschema #1: label]/ship_to/allOf[subschema #1: shipping_address_to]/allOf[subschema #1: address]/allOf[subschema #1: partial_address]/company_name` became nullable for the status `200` - the response property `allOf[subschema #1: label]/ship_to/allOf[subschema #1: shipping_address_to]/allOf[subschema #1: address]/allOf[subschema #1: partial_address]/email` became nullable for the status `200` - the response property `allOf[subschema #1: label]/ship_to/allOf[subschema #1: shipping_address_to]/allOf[subschema #2: partial_shipping_address_to]/instructions` became nullable for the status `200` - the response property `allOf[subschema #1: label]/shipment/allOf[subschema #1: shipment]/allOf[subschema #1: partial_shipment]/advanced_options/allOf[subschema #1: advanced_shipment_options]/additional_handling` became nullable for the status `200` - the response property `allOf[subschema #1: label]/shipment/allOf[subschema #1: shipment]/allOf[subschema #1: partial_shipment]/advanced_options/allOf[subschema #1: advanced_shipment_options]/ancillary_endorsements_option` became nullable for the status `200` - the response property `allOf[subschema #1: label]/shipment/allOf[subschema #1: shipment]/allOf[subschema #1: partial_shipment]/advanced_options/allOf[subschema #1: advanced_shipment_options]/bill_to_account` became nullable for the status `200` - the response property `allOf[subschema #1: label]/shipment/allOf[subschema #1: shipment]/allOf[subschema #1: partial_shipment]/advanced_options/allOf[subschema #1: advanced_shipment_options]/bill_to_postal_code` became nullable for the status `200` - the response property `allOf[subschema #1: label]/shipment/allOf[subschema #1: shipment]/allOf[subschema #1: partial_shipment]/advanced_options/allOf[subschema #1: advanced_shipment_options]/custom_field1` became nullable for the status `200` - the response property `allOf[subschema #1: label]/shipment/allOf[subschema #1: shipment]/allOf[subschema #1: partial_shipment]/advanced_options/allOf[subschema #1: advanced_shipment_options]/custom_field2` became nullable for the status `200` - the response property `allOf[subschema #1: label]/shipment/allOf[subschema #1: shipment]/allOf[subschema #1: partial_shipment]/advanced_options/allOf[subschema #1: advanced_shipment_options]/custom_field3` became nullable for the status `200` - the response property `allOf[subschema #1: label]/shipment/allOf[subschema #1: shipment]/allOf[subschema #1: partial_shipment]/advanced_options/allOf[subschema #1: advanced_shipment_options]/freight_class` became nullable for the status `200` - the response property `allOf[subschema #1: label]/shipment/allOf[subschema #1: shipment]/allOf[subschema #1: partial_shipment]/advanced_options/allOf[subschema #1: advanced_shipment_options]/movement_indicator` became nullable for the status `200` - the response property `allOf[subschema #1: label]/shipment/allOf[subschema #1: shipment]/allOf[subschema #1: partial_shipment]/advanced_options/allOf[subschema #1: advanced_shipment_options]/return_pickup_attempts` became nullable for the status `200` - the response property `allOf[subschema #1: label]/shipment/allOf[subschema #1: shipment]/allOf[subschema #1: partial_shipment]/advanced_options/allOf[subschema #1: advanced_shipment_options]/shipper_release` became nullable for the status `200` - the response property `allOf[subschema #1: label]/shipment/allOf[subschema #1: shipment]/allOf[subschema #1: partial_shipment]/advanced_options/allOf[subschema #1: advanced_shipment_options]/use_ups_ground_freight_pricing` became nullable for the status `200` - the response property `allOf[subschema #1: label]/shipment/allOf[subschema #1: shipment]/allOf[subschema #1: partial_shipment]/assigned_user` became nullable for the status `200` - the response property `allOf[subschema #1: label]/shipment/allOf[subschema #1: shipment]/allOf[subschema #1: partial_shipment]/comparison_rate_type` became nullable for the status `200` - the response property `allOf[subschema #1: label]/shipment/allOf[subschema #1: shipment]/allOf[subschema #1: partial_shipment]/deliver_by_date` became nullable for the status `200` - the response property `allOf[subschema #1: label]/shipment/allOf[subschema #1: shipment]/allOf[subschema #1: partial_shipment]/display_scheme` became nullable for the status `200` - the response property `allOf[subschema #1: label]/shipment/allOf[subschema #1: shipment]/allOf[subschema #1: partial_shipment]/external_order_id` became nullable for the status `200` - the response property `allOf[subschema #1: label]/shipment/allOf[subschema #1: shipment]/allOf[subschema #1: partial_shipment]/external_shipment_id` became nullable for the status `200` - the response property `allOf[subschema #1: label]/shipment/allOf[subschema #1: shipment]/allOf[subschema #1: partial_shipment]/hold_until_date` became nullable for the status `200` - the response property `allOf[subschema #1: label]/shipment/allOf[subschema #1: shipment]/allOf[subschema #1: partial_shipment]/internal_notes` became nullable for the status `200` - the response property `allOf[subschema #1: label]/shipment/allOf[subschema #1: shipment]/allOf[subschema #1: partial_shipment]/is_return` became nullable for the status `200` - the response property `allOf[subschema #1: label]/shipment/allOf[subschema #1: shipment]/allOf[subschema #1: partial_shipment]/items/items/allocation_status` became nullable for the status `200` - the response property `allOf[subschema #1: label]/shipment/allOf[subschema #1: shipment]/allOf[subschema #1: partial_shipment]/items/items/asin` became nullable for the status `200` - the response property `allOf[subschema #1: label]/shipment/allOf[subschema #1: shipment]/allOf[subschema #1: partial_shipment]/items/items/bundle_sku` became nullable for the status `200` - …112 more - **2026-10-13** `5bf6dc8ed400`: 1 breaking, 1 info - the `allOf[subschema #1: label]/delivery_prediction/allOf[subschema #1: delivery_prediction]/delivery_date` response's property format changed from `date-time` to `date` for status `200` - the `insured_value` response's property default value changed from `{"currency":"usd","amount":0}` to `{"currency":"usd","amount":0}` for the status `200` - **2026-10-09** `934f5935dbea`: 20 breaking, 26 warning, 82 info - request property `label_download_type` was restricted to a list of enum values - request property `validate_address` was restricted to a list of enum values - the `label_download_type` request property type changed from no type to `string` - the `validate_address` request property type changed from no type to `string` - the `allOf[subschema #1: label]/packages/items/allOf[subschema #1: label_package]/label_messages` response's property type changed from no type to `object` for status `200` - the `allOf[subschema #1: label]/rate_details/items/` response's property type changed from no type to `object` for status `200` - the `allOf[subschema #1: label]/ship_to/allOf[subschema #1: shipping_address_to]/allOf[subschema #1: address]/allOf[subschema #1: partial_address]/postal_code` response's property type changed from no type to `string` for status `200` - the `allOf[subschema #1: label]/shipment/allOf[subschema #1: 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: label]/shipment/allOf[subschema #1: shipment]/allOf[subschema #1: partial_shipment]/batch_ids/items/` response's property type changed from no type to `string` for status `200` - the `allOf[subschema #1: label]/shipment/allOf[subschema #1: shipment]/allOf[subschema #1: partial_shipment]/customs/allOf[subschema #1: international_shipment_options]/importer_of_record/allOf[subschema #1: importer_of_records]/postal_code` response's property type changed from no type to `string` for status `200` - the `allOf[subschema #1: label]/shipment/allOf[subschema #1: shipment]/allOf[subschema #1: partial_shipment]/items/items/` response's property type changed from no type to `object` for status `200` - the `allOf[subschema #1: label]/shipment/allOf[subschema #1: shipment]/allOf[subschema #1: partial_shipment]/order_source_code` response's property type changed from no type to `string` for status `200` - the `allOf[subschema #1: label]/shipment/allOf[subschema #1: shipment]/allOf[subschema #1: partial_shipment]/packages/items/` response's property type changed from no type to `object` for status `200` - the `allOf[subschema #1: label]/shipment/allOf[subschema #1: shipment]/allOf[subschema #1: partial_shipment]/return_to/allOf[subschema #1: shipping_address]/allOf[subschema #1: address]/allOf[subschema #1: partial_address]/postal_code` response's property type changed from no type to `string` for status `200` - the `allOf[subschema #1: label]/shipment/allOf[subschema #1: shipment]/allOf[subschema #1: partial_shipment]/ship_from/allOf[subschema #1: shipping_address]/allOf[subschema #1: address]/allOf[subschema #1: partial_address]/postal_code` response's property type changed from no type to `string` for status `200` - the `allOf[subschema #1: label]/shipment/allOf[subschema #1: shipment]/allOf[subschema #1: partial_shipment]/ship_to/allOf[subschema #1: shipping_address_to]/allOf[subschema #1: address]/allOf[subschema #1: partial_address]/postal_code` response's property type changed from no type to `string` for status `200` - the `allOf[subschema #1: label]/shipment/allOf[subschema #1: shipment]/allOf[subschema #1: partial_shipment]/tags/items/` response's property type changed from no type to `object` for status `200` - the `allOf[subschema #1: label]/shipment/allOf[subschema #1: shipment]/allOf[subschema #1: partial_shipment]/tax_identifiers/items/` response's property type changed from no type to `object` for status `200` - the `errors/items/` response's property type changed from no type to `object` for status `400` - the `errors/items/` response's property type changed from no type to `object` for status `404` - removed `#/components/schemas/label_download_type` from the `label_download_type` request property `allOf` list - removed `#/components/schemas/validate_address` from the `validate_address` request property `allOf` list - added the new `amazon_ca` enum value to the `allOf[subschema #1: label]/shipment/allOf[subschema #1: shipment]/allOf[subschema #1: partial_shipment]/order_source_code` response property for the response status `200` - added the new `amazon_us` enum value to the `allOf[subschema #1: label]/shipment/allOf[subschema #1: shipment]/allOf[subschema #1: partial_shipment]/order_source_code` response property for the response status `200` - added the new `any` enum value to the `allOf[subschema #1: label]/shipment/allOf[subschema #1: shipment]/allOf[subschema #1: partial_shipment]/advanced_options/allOf[subschema #1: advanced_shipment_options]/collect_on_delivery/payment_type` response property for the response status `200` - added the new `brightpearl` enum value to the `allOf[subschema #1: label]/shipment/allOf[subschema #1: shipment]/allOf[subschema #1: partial_shipment]/order_source_code` response property for the response status `200` - added the new `cash` enum value to the `allOf[subschema #1: label]/shipment/allOf[subschema #1: shipment]/allOf[subschema #1: partial_shipment]/advanced_options/allOf[subschema #1: advanced_shipment_options]/collect_on_delivery/payment_type` response property for the response status `200` - added the new `cash_equivalent` enum value to the `allOf[subschema #1: label]/shipment/allOf[subschema #1: shipment]/allOf[subschema #1: partial_shipment]/advanced_options/allOf[subschema #1: advanced_shipment_options]/collect_on_delivery/payment_type` response property for the response status `200` - added the new `channel_advisor` enum value to the `allOf[subschema #1: label]/shipment/allOf[subschema #1: shipment]/allOf[subschema #1: partial_shipment]/order_source_code` response property for the response status `200` - added the new `cratejoy` enum value to the `allOf[subschema #1: label]/shipment/allOf[subschema #1: shipment]/allOf[subschema #1: partial_shipment]/order_source_code` response property for the response status `200` - added the new `ebay` enum value to the `allOf[subschema #1: label]/shipment/allOf[subschema #1: shipment]/allOf[subschema #1: partial_shipment]/order_source_code` response property for the response status `200` - added the new `etsy` enum value to the `allOf[subschema #1: label]/shipment/allOf[subschema #1: shipment]/allOf[subschema #1: partial_shipment]/order_source_code` response property for the response status `200` - added the new `groupon_goods` enum value to the `allOf[subschema #1: label]/shipment/allOf[subschema #1: shipment]/allOf[subschema #1: partial_shipment]/order_source_code` response property for the response status `200` - added the new `jane` enum value to the `allOf[subschema #1: label]/shipment/allOf[subschema #1: shipment]/allOf[subschema #1: partial_shipment]/order_source_code` response property for the response status `200` - added the new `magento` enum value to the `allOf[subschema #1: label]/shipment/allOf[subschema #1: shipment]/allOf[subschema #1: partial_shipment]/order_source_code` response property for the response status `200` - added the new `none` enum value to the `allOf[subschema #1: label]/shipment/allOf[subschema #1: shipment]/allOf[subschema #1: partial_shipment]/advanced_options/allOf[subschema #1: advanced_shipment_options]/collect_on_delivery/payment_type` response property for the response status `200` - added the new `paypal` enum value to the `allOf[subschema #1: label]/shipment/allOf[subschema #1: shipment]/allOf[subschema #1: partial_shipment]/order_source_code` response property for the response status `200` - added the new `seller_active` enum value to the `allOf[subschema #1: label]/shipment/allOf[subschema #1: shipment]/allOf[subschema #1: partial_shipment]/order_source_code` response property for the response status `200` - added the new `shopify` enum value to the `allOf[subschema #1: label]/shipment/allOf[subschema #1: shipment]/allOf[subschema #1: partial_shipment]/order_source_code` response property for the response status `200` - added the new `squarespace` enum value to the `allOf[subschema #1: label]/shipment/allOf[subschema #1: shipment]/allOf[subschema #1: partial_shipment]/order_source_code` response property for the response status `200` - …88 more - **2026-09-24** `2d228135b6f1`: 1 breaking, 6 warning, 1 info - the `allOf[subschema #1: label]/rate_details/items/` response's property type changed from `object` to no type for status `200` - removed the optional property `allOf[subschema #1: label]/rate_details/items/amount` from the response with the `200` status - removed the optional property `allOf[subschema #1: label]/rate_details/items/billing_source` from the response with the `200` status - removed the optional property `allOf[subschema #1: label]/rate_details/items/carrier_billing_code` from the response with the `200` status - removed the optional property `allOf[subschema #1: label]/rate_details/items/carrier_description` from the response with the `200` status - removed the optional property `allOf[subschema #1: label]/rate_details/items/carrier_memo` from the response with the `200` status - removed the optional property `allOf[subschema #1: label]/rate_details/items/rate_detail_type` from the response with the `200` status - added `#/components/schemas/rate_detail` to the `allOf[subschema #1: label]/rate_details/items/` response property `allOf` list for the response status `200` - **2026-09-10** `41bf3a6debc7`: 1 warning - removed the optional property `allOf[subschema #1: label]/delivery_prediction` from the response with the `200` status - **2026-09-09** `dc74a6387377`: 2 info - added the optional property `allOf[subschema #1: label]/delivery_prediction` to the response with the `200` status - added the optional property `allOf[subschema #1: label]/shipment/allOf[subschema #1: shipment]/allOf[subschema #1: partial_shipment]/batch_ids` to the response with the `200` status - **2026-09-05** `17802d3fbe61`: 2 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` - **2026-09-04** `03ca91027c15`: 1 info - added the optional property `allOf[subschema #1: label]/shipment/allOf[subschema #1: 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** `cc0116dfedb6`: 1 info - added the optional property `allOf[subschema #1: label]/shipment/allOf[subschema #1: 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** `0e61ae174690`: 1 info - added the optional property `allOf[subschema #1: label]/shipment/allOf[subschema #1: 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** `13c58f90de0b`: 2 warning - added the new `adult_signature_restricted_delivery` enum value to the `allOf[subschema #1: label]/confirmation/allOf[subschema #1: delivery_confirmation]/` response property for the response status `200` - added the new `adult_signature_restricted_delivery` enum value to the `allOf[subschema #1: label]/shipment/allOf[subschema #1: shipment]/allOf[subschema #1: partial_shipment]/confirmation/allOf[subschema #1: delivery_confirmation]/` response property for the response status `200` - **2026-08-15** `e9b68942091c`: 12 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_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_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_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_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_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` --- [Operation](https://skmtc.dev/shipstation/apis/shipstation-api-v2/docs/v2/labels/shipment/:shipment_id/post.md) - [API](https://skmtc.dev/shipstation/apis/shipstation-api-v2.md) - [Page](https://skmtc.dev/shipstation/apis/shipstation-api-v2/changes/v2/labels/shipment/:shipment_id/post)