---
title: "Move document"
method: PUT
path: "/api/v1/documents/{identifier}/move"
tags: ["Documents"]
---

# Move document

`PUT /api/v1/documents/{identifier}/move`

## Path parameters

- `identifier` string, required — Document identifier (either document ID or identifier slug)

## Request body

- DocumentsMoveBody
  - `folderPath` string, nullable, required — Destination folder path (null for root)
  - `scope` 'restricted' | 'organization' — Access scope for the document

## Response `200`

Document moved successfully

- SuccessResponse
  - `success` boolean, required — Whether the operation was successful

## Other responses

- `400` — Invalid folder path or scope
- `401` — Authentication required
- `403` — Permission denied - MANAGER role required
- `404` — Document or folder not found

---

[API](https://skmtc.net/omniapp/apis/omni-api.md) · [All operations](https://skmtc.net/omniapp/apis/omni-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/omniapp/omni-api/versions/4701f292c621/schema)