---
title: "Move a document, or change where it sits among its neighbours"
method: POST
path: "/note.document.move"
tags: ["note"]
---

# Move a document, or change where it sits among its neighbours

`POST /note.document.move`

Moves the document with everything nested under it: to another collection, under another parent, to another place in the list of its neighbours, or all three at once. The request describes where the document lands, not what changes about it - an absent `collectionId` means the collection it is in now, an absent `parentId` means a root of the target collection, so a reorder among children names its parent too. `position` is the sort weight the listings answer with: pass a number between the weights of two neighbours to land between them, and omit it to land last. The weight actually stored is recomputed from the neighbours - it may differ from the one asked for - so the answer carries the document as it was saved. Requires the right to edit both the collection the document leaves and the one it enters. A move into a branch shared with a wider audience is refused separately, as `NOTE_MOVE_ACCESS_ESCALATION`: it would hand that audience everything being moved.

## Request body

- object
  - `id` integer, required
  - `collectionId` integer
  - `parentId` integer
  - `position` integer

## Response `200`

Success response

- object
  - `result` object
    - `item` BitrixNoteDocumentitemdto
      - `id` integer
      - `collectionId` integer
      - `parentId` integer
      - `title` string
      - `markdown` string
      - `position` integer
      - `createdBy` integer
      - `updatedBy` integer
      - `createdAt` string, date-time
      - `updatedAt` string, date-time
      - `contentUpdatedAt` string, date-time
      - `isArchived` boolean
      - `isTrashed` boolean
      - `isOrphan` boolean

## Changes

- **2026-09-29** `f6be0a558c33` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/bitrix24/apis/bitrix24-rest-v3-api/changes/note.document.move/post.md)

---

[API](https://skmtc.dev/bitrix24/apis/bitrix24-rest-v3-api.md) · [All operations](https://skmtc.dev/bitrix24/apis/bitrix24-rest-v3-api/llms.txt) · [OpenAPI document](https://skmtc.dev/bitrix24/apis/bitrix24-rest-v3-api/revisions/f6be0a558c33?raw)