---
title: "Changes to Hold shipments"
method: POST
path: "/v2/shipments/hold"
---

# Changes to Hold shipments

`POST /v2/shipments/hold`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 3 of 30 revisions.

- **2026-10-22** `4e29670aa28d`: 12 warning
- **2026-10-09** `934f5935dbea`: 9 breaking, 2 warning, 32 info
- **2026-10-02** `0cf052f808b4`: 1 info

## Changes

- **2026-10-22** `4e29670aa28d`: 12 warning
  - added the new `bring_your_own_label_not_supported` enum value to the `errors/items/error_code` response property for the response status `200`
  - added the new `bring_your_own_label_not_supported` enum value to the `errors/items/error_code` response property for the response status `207`
  - 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 `200`
  - added the new `multiple_sales_orders` enum value to the `errors/items/error_code` response property for the response status `207`
  - 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 `200`
  - added the new `sales_order_link_required` enum value to the `errors/items/error_code` response property for the response status `207`
  - 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`
- **2026-10-09** `934f5935dbea`: 9 breaking, 2 warning, 32 info
  - the `shipment_ids/items/` request property's minLength was increased from `0` to `1`
  - added the pattern `^se(-[a-z0-9]+)+$` to the request property `shipment_ids/items/`
  - the `shipment_ids/items/` request property type changed from no type to `string`
  - the `errors/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 `207`
  - 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`
  - the `shipment_ids/items/` response's property type changed from no type to `string` for status `200`
  - the `shipment_ids/items/` response's property type changed from no type to `string` for status `207`
  - removed `#/components/schemas/se_id` from the `shipment_ids/items/` request property `allOf` list
  - the `shipment_ids/items/` request property's maxLength was set to `25`
  - added the optional property `errors/items/field_name` to the response with the `200` status
  - added the optional property `errors/items/field_name` to the response with the `207` status
  - added the optional property `errors/items/field_name` to the response with the `400` status
  - added the optional property `errors/items/field_name` to the response with the `404` status
  - added the optional property `errors/items/field_value` to the response with the `200` status
  - added the optional property `errors/items/field_value` to the response with the `207` status
  - added the optional property `errors/items/field_value` to the response with the `400` status
  - added the optional property `errors/items/field_value` to the response with the `404` status
  - removed `#/components/schemas/error` from the `errors/items/` response property `allOf` list for the response status `200`
  - removed `#/components/schemas/error` from the `errors/items/` response property `allOf` list for the response status `207`
  - removed `#/components/schemas/error` from the `errors/items/` response property `allOf` list for the response status `400`
  - removed `#/components/schemas/error` from the `errors/items/` response property `allOf` list for the response status `404`
  - removed `#/components/schemas/se_id` from the `shipment_ids/items/` response property `allOf` list for the response status `200`
  - removed `#/components/schemas/se_id` from the `shipment_ids/items/` response property `allOf` list for the response status `207`
  - the `shipment_ids/items/` response's property pattern `^se(-[a-z0-9]+)+$` was added for the status `200`
  - the `shipment_ids/items/` response's property pattern `^se(-[a-z0-9]+)+$` was added for the status `207`
  - added the required property `errors/items/error_code` to the response with the `200` status
  - added the required property `errors/items/error_code` to the response with the `207` status
  - added the required property `errors/items/error_code` to the response with the `400` status
  - added the required property `errors/items/error_code` to the response with the `404` status
  - added the required property `errors/items/error_source` to the response with the `200` status
  - added the required property `errors/items/error_source` to the response with the `207` status
  - added the required property `errors/items/error_source` to the response with the `400` status
  - added the required property `errors/items/error_source` to the response with the `404` status
  - added the required property `errors/items/error_type` to the response with the `200` status
  - added the required property `errors/items/error_type` to the response with the `207` status
  - added the required property `errors/items/error_type` to the response with the `400` status
  - added the required property `errors/items/error_type` to the response with the `404` status
  - added the required property `errors/items/message` to the response with the `200` status
  - …3 more
- **2026-10-02** `0cf052f808b4`: 1 info
  - endpoint added

---

[Operation](https://skmtc.dev/shipstation/apis/shipstation-api-v2/docs/v2/shipments/hold/post.md) - [API](https://skmtc.dev/shipstation/apis/shipstation-api-v2.md) - [Page](https://skmtc.dev/shipstation/apis/shipstation-api-v2/changes/v2/shipments/hold/post)