---
title: "Changes to Update Return"
method: PUT
path: "/wms/returns/{return_id}"
---

# Changes to Update Return

`PUT /wms/returns/{return_id}`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 1 of 4 revisions.

- **2026-11-03** `f9f948f2a7b3`: 6 breaking, 7 info

## Changes

- **2026-11-03** `f9f948f2a7b3`: 6 breaking, 7 info
  - removed `#/components/schemas/UpdateReturnSchema--Base__Schema--` from the request body `oneOf` list
  - added `subschema #1` to the `oneOf[subschema #3: Deposco -> subschema #5: Deposco]/line_items/items/` request property `allOf` list
  - added the pattern `^[0-9]+$` to the request property `oneOf[subschema #12: ShipStream -> subschema #15: ShipStream]/carrier_tracking_number`
  - added the pattern `^[0-9]+$` to the request property `oneOf[subschema #12: ShipStream -> subschema #15: ShipStream]/warehouse_id`
  - added the pattern `^[0-9]+$` to the request property `oneOf[subschema #4: Infoplus -> subschema #7: Infoplus]/warehouse_id`
  - added the pattern `^[0-9]+$` to the request property `oneOf[subschema #7: Ongoing WMS -> subschema #11: Ongoing WMS]/warehouse_id`
  - added the new optional `header` request parameter `Idempotency-Key`
  - added the new optional request property `oneOf[subschema #3: Deposco -> subschema #5: Deposco]/custom_attribute_1`
  - added the new optional request property `oneOf[subschema #3: Deposco -> subschema #5: Deposco]/line_items/items/custom_attribute_1`
  - added the new optional request property `oneOf[subschema #3: Deposco -> subschema #5: Deposco]/order_source`
  - added the new optional request property `oneOf[subschema #3: Deposco -> subschema #5: Deposco]/other_reference_number`
  - added `#/components/schemas/UpdatewmsReturn--Boxzooka--, #/components/schemas/UpdatewmsReturn--J_AMP_J__Global__Fulfillment__-_Control__Port_---, #/components/schemas/UpdatewmsReturn--Everstox--, #/components/schemas/UpdatewmsReturn--Luminous--` to the request body `oneOf` list
  - added `id, name` discriminator mapping keys to the `oneOf[subschema #4: Infoplus -> subschema #7: Infoplus]/supplier_object` request property

---

[Operation](https://skmtc.dev/trackstarhq/apis/trackstar-api/docs/wms/returns/:return_id/put.md) - [API](https://skmtc.dev/trackstarhq/apis/trackstar-api.md) - [Page](https://skmtc.dev/trackstarhq/apis/trackstar-api/changes/wms/returns/:return_id/put)