---
title: "Changes to Create a return"
method: POST
path: "/returns"
---

# Changes to Create a return

`POST /returns`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 1 of 11 revisions.

- **2026-07-13** `859097ed3fe6`: 3 breaking, 4 warning, 5 info

## Changes

- **2026-07-13** `859097ed3fe6`: 3 breaking, 4 warning, 5 info
  - added the new required request property `data/relationships/order/data`
  - added the new required request property `data/relationships/stock_location/data`
  - request property `data/type` was restricted to a list of enum values
  - removed the request property `data/relationships/order/id`
  - removed the request property `data/relationships/order/type`
  - removed the request property `data/relationships/stock_location/id`
  - removed the request property `data/relationships/stock_location/type`
  - added the new optional request property `data/relationships/reference_capture`
  - added the new optional request property `data/relationships/tags`
  - the `type` request property default value `returns` was removed
  - added the new `returns` enum value to the request property `data/type`
  - added the media type `application/vnd.api+json` for the response with the status `201`

---

[Operation](https://skmtc.dev/commercelayer/apis/commerce-layer-api/docs/returns/post.md) - [API](https://skmtc.dev/commercelayer/apis/commerce-layer-api.md) - [Page](https://skmtc.dev/commercelayer/apis/commerce-layer-api/changes/returns/post)