---
title: "Edit Transfer Order"
method: PUT
path: "/transfer-orders/{id}"
tags: ["transfer_order"]
---

# Edit Transfer Order

`PUT /transfer-orders/{id}`

## Request

- Base URL: `https://app.zenventory.com/rest`
- URL: `https://app.zenventory.com/rest/transfer-orders/{id}`
- Auth: none declared

Edit a transfer order.

## Path parameters

- `id` integer, required

## Request body

- object
  - `originWarehouseId` integer, required: Id of the warehouse the inventory is being transferred from.
  - `originWarehouseName` string, required: Name of the warehouse the inventory is being transferred from. Ignored if originWarehouseId is provided.
  - `destinationWarehouseId` integer, required: Id of the warehouse the inventory is being transferred to.
  - `destinationWarehouseName` string, required: Name of the warehouse the inventory is being transferred to. Ignored if destinationWarehouseId is provided.
  - `requiredBy` unknown, required
  - `draft` boolean: True if the transfer order is a draft.
  - `shipVia` string: The code of the carrier or service to use for shipping.
  - `notes` string
  - `items` object[]: Items being transferred. Exclude an existing line item to leave it unchanged.
    - `id` integer, required: Id of the transfer order line item. Must be provided to edit an existing line item. If not provided, then the item will be added as a new line item to the transfer order.
    - `itemId` integer, required: Id of the item master.
    - `sku` string, required: SKU of the item master. Ignored if itemId is provided.
    - `quantity` integer, required: How many are being transferred. Set the quantity to zero if you wish to remove the line item.

## Response `200`

Success

- TransferOrder
  - `id` integer
  - `originWarehouse` WarehouseCompact
    - `id` integer
    - `name` string
  - `destinationWarehouse` WarehouseCompact
    - `id` integer
    - `name` string
  - `draft` boolean
  - `completed` boolean
  - `requiredBy` string, date-time
  - `createdDate` string, date-time
  - `preparedBy` UserCompact
    - `id` integer
    - `name` string
  - `preparedDate` string, date-time
  - `shipVia` string
  - `deleted` boolean
  - `deletedBy` UserCompact
    - `id` integer
    - `name` string
  - `deletedDate` string, date-time
  - `cancelled` boolean
  - `cancelledBy` UserCompact
    - `id` integer
    - `name` string
  - `cancelledDate` string, date-time
  - `cancelledReason` string
  - `notes` string
  - `tags` Tag[]
    - `id` integer
    - `tag` string
    - `note` string
  - `items` TransferOrderItem[]
    - `id` integer
    - `itemId` integer
    - `sku` string
    - `description` string
    - `quantity` integer
    - `uom` string
    - `allocatedQuantity` integer
    - `pickedQuantity` integer
    - `deliveredQuantity` integer

---

[API](https://skmtc.dev/zenventory/apis/zenventory-rest-api.md) · [All operations](https://skmtc.dev/zenventory/apis/zenventory-rest-api/llms.txt) · [OpenAPI document](https://skmtc.dev/zenventory/apis/zenventory-rest-api/revisions/b40aa340773b?raw)
