---
title: "Move Workspace File"
method: POST
path: "/v1/files/move"
tags: ["v1", "protected", "files"]
---

# Move Workspace File

`POST /v1/files/move`

Relocate a workspace file or folder to another path.

A folder is a key prefix rather than an object, so moving one walks every
key beneath it — including the trailing-slash marker that keeps an empty
folder visible in the listing. Reserved prefixes are refused at both ends:
``tasks/`` belongs to a task's committed manifest, and ``.trash/`` is the
restore endpoint's alone.

## Request body

- MoveWorkspaceFileRequest
  - `destination` string, required
  - `source` string, required

## Response `200`

Successful Response

- MovedFileResponse
  - `destination` string, required
  - `moved` integer, required
  - `source` string, required

## Other responses

- `422` — Validation Error

## Changes

- **2026-09-17** `e641bee7f63d` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/agentarea/apis/agentarea-api/changes/v1/files/move/post.md)

---

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