---
title: "Move Items"
method: POST
path: "/fs-items/move"
tags: ["Filesystem Items"]
---

# Move Items

`POST /fs-items/move`

## Request

- Base URL: `https://api.aspect.inc`
- URL: `https://api.aspect.inc/fs-items/move`
- Auth: API key in header `Authorization`

Move assets and directories into a directory.

## Request body

- FsItemsMoveRequest: API request schema for moving filesystem items to a new parent directory
  - `asset_ids` string[], nullable: List of asset IDs to move
  - `directory_ids` string[], nullable: List of directory IDs to move
  - `symlink_ids` string[], nullable: List of symlink IDs to move
  - `destination_directory_id` string, uuid, required: ID of the destination parent directory

## Response `200`

Successful Response

- FsItemsMoveResponse: API response schema for moving filesystem items
  - `moved_asset_count` integer, required: Number of assets successfully moved
  - `moved_directory_count` integer, required: Number of directories successfully moved
  - `moved_symlink_count` integer: Number of symlinks successfully moved

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/aspect/apis/aspect-api.md) - [All operations](https://skmtc.dev/aspect/apis/aspect-api/llms.txt) - [OpenAPI document](https://skmtc.dev/aspect/apis/aspect-api/revisions/28ea5f1adb54?raw)
