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

Изменить порядок баз знаний

POST /v1/note/collections/:id/move

Меняет порядок для всего аккаунта Битрикс24. Без position или с null коллекция становится последней. Сохранённый вес вычисляется по соседям и может отличаться от запроса.

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

Параметры

Параметр Тип Обяз. Описание
Параметрid (path) Типinteger Обяз.да ОписаниеGET /v1/note/collections/:id
Параметрposition (body) Типinteger / null Обяз.нет ОписаниеЗнаковое безопасное целое. Без поля/null: последняя позиция.

Примеры

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

Terminal 

curl -X POST https://vibecode.bitrix24.tech/v1/note/collections/33/move \
  -H "X-Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"position": -10}'

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

Terminal 

curl -X POST https://vibecode.bitrix24.tech/v1/note/collections/33/move \
  -H "X-Api-Key: YOUR_APP_KEY" \
  -H "Authorization: Bearer USER_SESSION_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"position": -10}'

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

javascript 

const response = await fetch('https://vibecode.bitrix24.tech/v1/note/collections/33/move', {
  method: 'POST',
  headers: { 'X-Api-Key': 'YOUR_API_KEY', 'Content-Type': 'application/json' },
  body: JSON.stringify({"position": -10}),
})
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/collections/33/move', {
  method: 'POST',
  headers: { 'X-Api-Key': 'YOUR_APP_KEY', 'Content-Type': 'application/json', 'Authorization': 'Bearer USER_SESSION_TOKEN' },
  body: JSON.stringify({"position": -10}),
})
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/collections/:id

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

JSON 

{
  "success": true,
  "data": {
    "id": 33,
    "name": "VIBE-PROBE MR-5082 collection 1",
    "position": 50,
    "policyLevel": "private",
    "accessLevel": "full",
    "isArchived": false,
    "createdBy": 1373,
    "createdAt": "2026-10-02T22:43:23+03:00",
    "updatedBy": 1373,
    "updatedAt": "2026-10-02T22:43:24+03:00",
    "markdownDescription": null
  }
}

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.

Все ошибки

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