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

# Move document

`PUT /v1/documents/{documentId}/move`

Move a document to new folder or change scope.

## Path parameters

- `documentId` string, required

## Request body

- object
  - `folderPath` string, nullable, required — The path of the destination folder. Use `null` to move the document to the root level (no folder).
  - `scope` 'organization' | 'restricted' — Optional sharing scope for the document: - `organization` - Organization-wide access - `restricted` - Limited access If not provided, the scope will be computed based on the document or the destination folder. **Note**: When providing a scope, it must match the destination folder's scope.

## Response `200`

Document moved successfully

- SuccessResponse
  - `success` boolean

## Other responses

- `400` — Bad Request Possible error messages: - `Scope "<scope>" and folder scope "<folderScope>" do not match` - `Invalid method`
- `403` — Forbidden Possible error messages/causes: - `User-scoped API keys cannot act on behalf of other users` - Operations targeting personal/restricted scope require the user's **Personal content access** setting (`omni_allows_personal_content` system attribute) to be enabled for the user. If not enabled, the API will respond with `403 Forbidden`.
- `404` — Not Found Possible error messages: - `Document with identifier "<documentId>" not found` - `Folder with path <path> does not exist`
- `429` — Too Many Requests - Rate limit exceeded (60 requests/minute)

---

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