Для AI-агентов: markdown этой страницы — /docs-content/note/documents/move.md индекс документации — /llms.txt

Перенести документ с поддеревом

POST /v1/note/documents/:id/move

Переносит документ вместе со всеми потомками. Без collectionId остаётся текущая коллекция. Отсутствующий или null parentId означает корень. Родитель должен принадлежать целевой коллекции. Битрикс24 отклоняет циклы и переносы с расширением доступа.

Нужен скоуп note и ключ с разрешённой записью. Архивные коллекции доступны только для чтения. Права проверяет Битрикс24.

Параметры

Параметр Тип Обяз. Описание
Параметрid (path) Типinteger Обяз.да ОписаниеGET /v1/note/documents/:id
Параметрposition (body) Типinteger / null Обяз.нет ОписаниеЗнаковое безопасное целое. Без поля/null: последняя позиция.
ПараметрcollectionId (body) Типinteger / null Обяз.нет ОписаниеПоложительное безопасное целое. Список коллекций. Без поля/null: текущая.
ПараметрparentId (body) Типinteger / null Обяз.нет ОписаниеПоложительное безопасное целое. Дерево документов. Без поля/null: корень.

Примеры

curl — личный ключ

Terminal 

curl -X POST https://vibecode.bitrix24.tech/v1/note/documents/85/move \
  -H "X-Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"collectionId": 35, "position": -20}'

curl — OAuth-приложение

Terminal 

curl -X POST https://vibecode.bitrix24.tech/v1/note/documents/85/move \
  -H "X-Api-Key: YOUR_APP_KEY" \
  -H "Authorization: Bearer USER_SESSION_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"collectionId": 35, "position": -20}'

JavaScript — личный ключ

javascript 

const response = await fetch('https://vibecode.bitrix24.tech/v1/note/documents/85/move', {
  method: 'POST',
  headers: { 'X-Api-Key': 'YOUR_API_KEY', 'Content-Type': 'application/json' },
  body: JSON.stringify({"collectionId": 35, "position": -20}),
})
const result = await response.json()
if (!response.ok) throw new Error(result.error.message)
console.log(result.data)

JavaScript — OAuth-приложение

javascript 

const response = await fetch('https://vibecode.bitrix24.tech/v1/note/documents/85/move', {
  method: 'POST',
  headers: { 'X-Api-Key': 'YOUR_APP_KEY', 'Content-Type': 'application/json', 'Authorization': 'Bearer USER_SESSION_TOKEN' },
  body: JSON.stringify({"collectionId": 35, "position": -20}),
})
const result = await response.json()
if (!response.ok) throw new Error(result.error.message)
console.log(result.data)

Поля ответа

Поле Тип Описание
Полеsuccess Типboolean Описаниеtrue
Полеdata Типobject ОписаниеGET /v1/note/documents/:id

Ответ перечитывается после переноса. Если чтение не удалось, изменение уже могло сохраниться: перечитайте объект перед повтором.

JSON 

{
  "success": true,
  "data": {
    "id": 85,
    "collectionId": 35,
    "parentId": null,
    "title": "VIBE-PROBE MR-5082 document",
    "markdown": "VIBE-PROBE content",
    "position": 1000,
    "createdBy": 1373,
    "updatedBy": 1373,
    "createdAt": "2026-10-02T22:43:23+03:00",
    "updatedAt": "2026-10-02T22:43:24+03:00",
    "contentUpdatedAt": "2026-10-02T22:43:23+03:00",
    "isArchived": false,
    "isTrashed": false,
    "isOrphan": false
  }
}

400 — неверный id в пути:

JSON 

{
  "success": false,
  "error": {
    "code": "INVALID_PARAMS",
    "message": "id must be a positive integer"
  }
}

Ошибки

HTTP Code Условие
HTTP400 CodeINVALID_PARAMS УсловиеНеверный id, адрес назначения или тело.
HTTP401 CodeMISSING_API_KEY УсловиеНет ключа.
HTTP401 CodeTOKEN_MISSING УсловиеНет подключения к Битрикс24.
HTTP403 CodeSCOPE_DENIED Условиеnote
HTTP403 CodeWRITE_BLOCKED_READONLY_KEY УсловиеREADONLY
HTTP403 CodeBITRIX_ACCESS_DENIED УсловиеОтказ доступа Битрикс24, включая запись в архивную коллекцию.
HTTP404 CodeENTITY_NOT_FOUND УсловиеЗапись отсутствует или не видна; документ архивирован.
HTTP422 CodeBITRIX_ERROR УсловиеЦикл, расширение доступа или другой бизнес-отказ.
HTTP429 CodeOPERATION_TIME_LIMIT УсловиеЛимит операций Битрикс24.
HTTP502 CodeBITRIX_UNAVAILABLE УсловиеБитрикс24 недоступен.
HTTP503 CodeBITRIX_TIMEOUT УсловиеТаймаут Битрикс24.

Все ошибки

Смотрите также