---
title: "Move Inventory"
method: PUT
path: "/inventory/move"
tags: ["inventory"]
---

# Move Inventory

`PUT /inventory/move`

## Request

- Base URL: `https://app.allocadence.com/rest`
- URL: `https://app.allocadence.com/rest/inventory/move`
- Auth: none declared

Move inventory from one location to another location in the same warehouse.

## Request body

- object
  - `warehouseId` integer: Id of the warehouse the inventory is in. If no warehouse parameters are given, then the user's current warehouse will be used.
  - `warehouseName` string: Name of the warehouse the inventory is in. If no warehouse parameters are given, then the user's current warehouse will be used.
  - `originLocationId` integer, required: Id of the location the inventory is being moved from.
  - `originLocationName` string, required: Name of the location the inventory is being moved from. Ignored if originLocationId is provided.
  - `note` string: A note about the inventory moves.
  - `destinations` object[]: List of inventory moves to be made.
    - `locationId` integer, required: Id of the location the inventory is being moved to.
    - `locationName` string, required: Name of the location the inventory is being moved to. Ignored if locationId is provided.
    - `items` object[]
      - `itemId` integer, required: Id of the item whose stock is being moved.
      - `sku` string, required: SKU of the item whose stock is being moved. Ignored if itemId is provided.
      - `quantity` string: The amount of stock to be moved.
      - `moveAll` boolean: True to ignore quantity and move all stock of the item at the location.
      - `lotNumber` string: Only move stock with this lot number. Only used if the item tracks lots.
      - `expirationDate` string, date-time: Only move stock with this expiration date. Only used fi the item is perishable.
      - `serialNumbers` unknown[]: List of serial numbers being moved. Unless moveAll is true, this is required if item is serialized and must match quantity.
        - unknown

## Response `200`

Success

- InventoryMoveResponse
  - `hasErrors` boolean: True if any destinations had at least one error.
  - `successfulDestinations` object[]: Associative array of destinations that had no errors. Indexed by their index from the request.
    - `error` ErrorResponse
      - `code` 'forbidden' | 'invalid_action' | 'invalid_object' | 'invalid_parameter' | 'invalid_parameter_missing' | 'not_found' | 'server' | 'unauthorized' | 'undefined': The code for the error.
      - `message` string: A message describing the error.
      - `parameter` union: The parameter that caused the error. Only for invalid_parameter and invalid_parameter_missing errors.
        - string
        - unknown
    - `successfulItems` unknown[]: Associative array of successful item movements. Indexed by their index from the request.
      - unknown
    - `failedItems` ErrorResponse[]: Associative array of failed item movements. Indexed by their index from the request.
      - `code` 'forbidden' | 'invalid_action' | 'invalid_object' | 'invalid_parameter' | 'invalid_parameter_missing' | 'not_found' | 'server' | 'unauthorized' | 'undefined': The code for the error.
      - `message` string: A message describing the error.
      - `parameter` union: The parameter that caused the error. Only for invalid_parameter and invalid_parameter_missing errors.
        - string
        - unknown
  - `failedDestinations` object[]: Associative array of destinations that had at least one error. Indexed by their index from the request.
    - `error` ErrorResponse
      - `code` 'forbidden' | 'invalid_action' | 'invalid_object' | 'invalid_parameter' | 'invalid_parameter_missing' | 'not_found' | 'server' | 'unauthorized' | 'undefined': The code for the error.
      - `message` string: A message describing the error.
      - `parameter` union: The parameter that caused the error. Only for invalid_parameter and invalid_parameter_missing errors.
        - string
        - unknown
    - `successfulItems` unknown[]: Associative array of successful item movements. Indexed by their index from the request.
      - unknown
    - `failedItems` ErrorResponse[]: Associative array of failed item movements. Indexed by their index from the request.
      - `code` 'forbidden' | 'invalid_action' | 'invalid_object' | 'invalid_parameter' | 'invalid_parameter_missing' | 'not_found' | 'server' | 'unauthorized' | 'undefined': The code for the error.
      - `message` string: A message describing the error.
      - `parameter` union: The parameter that caused the error. Only for invalid_parameter and invalid_parameter_missing errors.
        - string
        - unknown

---

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