---
title: "Order Put Back Stock"
method: POST
path: "/api/order/putBackStock"
tags: ["Order"]
---

# Order Put Back Stock

`POST /api/order/putBackStock`

## Request

- Base URL: `https://api.desty.app`
- URL: `https://api.desty.app/api/order/putBackStock`
- Auth: none declared. Required headers: `Authorization`

<span class="colour" style="color:rgb(0, 0, 0)">API to e</span>xecute product returns for the specified order. <span class="colour" style="color:rgb(85, 85, 85)">Only DeliveryFailed "Cancellations" status orders support putting back stock.</span> The returned items must be included in the Get Order Put Back Item Info and the return quantity must be less than or equal to the original order quantity.

## Headers

- `Authorization` string, required

## Request body

- object
  - `orderId` string, required: Desty Omnichannel internal Return Order ID retrieved from List Order API, not marketplace ID
  - `warehouseId` string, required: warehouse id, only warehouse_id retrieved on externalWarehouseId will be authenticated, mapped, and allowed to put back stock
  - `items` object[]: List of returned items
    - `skuNumber` string, required: skuCode
    - `putBackQuantity` number, required: Quantity returned
    - `unitCost` number: Required for FIFO/Average user

## Response `200`

successful operation

- object
  - `code` string: code
  - `msg` string: msg
  - `data` boolean: true or false. true = API response is successfully received; false = API response is failed

---

[API](https://skmtc.dev/desty/apis/desty-omni-openapi-2026-6-26.md) - [All operations](https://skmtc.dev/desty/apis/desty-omni-openapi-2026-6-26/llms.txt) - [OpenAPI document](https://skmtc.dev/desty/apis/desty-omni-openapi-2026-6-26/revisions/4946760fb77d?raw)