# Move

Moves a quantity of an item to a different folder. The moved portion becomes a separate
item in the destination, with its own id and the same sid.

- folder_id is the destination. Pass null to move to the root level.
- leave_zero_quantity: true keeps a zero-quantity record in the source folder. The
  default, false, removes the source item once its quantity reaches 0.

Endpoint: POST /api/v1/items/{item_id}/move
Security: BearerAuth

## Path parameters:

  - `item_id` (number, required)
    Item ID
    Example: "2"

## Request fields (application/json):

  - `quantity` (number, required)
    Move quantity of item

  - `folder_id` (number)
    Target folder ID. If not defined then will be moved to root

  - `leave_zero_quantity` (boolean)
    Determines wether items with zero quantity are kept or not. Default is false.

## Response 200 fields (application/json):

  - `data` (object)

  - `data.id` (number)

  - `data.name` (string)

  - `data.price` (number)

  - `data.quantity` (number)

  - `data.notes` (string)

  - `data.parent_id` (number)

  - `data.sid` (string)

  - `data.tag_names` (array)

  - `data.tags` (array)

  - `data.type` (string)

  - `data.created_at` (string)

  - `data.updated_at` (string)

## Response 400 fields (application/json):

  - `message` (string)

## Response 401 fields (application/json):

  - `message` (string)

## Response 404 fields (application/json):

  - `message` (string)

## Response 429 fields (application/json):

  - `message` (string)