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

Поднять блок

POST /v1/pages/:pageId/blocks/:blockId/up

Сдвигает на одну позицию вверх. Первый блок даёт 409 BLOCK_WRONG_SORT.

Требуется скоуп landing. READONLY-ключ получает 403 до обращения к Б24. Правится черновик.

Параметры запроса

Поле	Тип	Обяз.	Описание
`pageId`	integer	да	Исходная страница из списка страниц.
`blockId`	integer	да	Блок исходной страницы. ID можно взять из ответа copy/move.
`scope`	string	нет	Query: KNOWLEDGE, GROUP, MAINPAGE; для обычных сайтов не нужен.

Примеры

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

Terminal

curl -X POST "https://vibecode.bitrix24.tech/v1/pages/42/blocks/31/up" \
  -H "X-Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'

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

Terminal

curl -X POST "https://vibecode.bitrix24.tech/v1/pages/42/blocks/31/up" \
  -H "X-Api-Key: YOUR_APP_KEY" \
  -H "Authorization: Bearer USER_SESSION_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'

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

javascript

const response = await fetch("https://vibecode.bitrix24.tech/v1/pages/42/blocks/31/up", {
  method: "POST",
  headers: { "X-Api-Key": "YOUR_API_KEY", "Content-Type": "application/json" },
  body: JSON.stringify({})
});
const result = await response.json();

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

javascript

const response = await fetch("https://vibecode.bitrix24.tech/v1/pages/42/blocks/31/up", {
  method: "POST",
  headers: { "X-Api-Key": "YOUR_APP_KEY", "Authorization": "Bearer USER_SESSION_TOKEN", "Content-Type": "application/json" },
  body: JSON.stringify({})
});
const result = await response.json();

Поля ответа

Поле	Тип	Описание
`success`	boolean	Успешный ответ.
`data`	object	Результат операции.
`data.pageId`	integer	ID страницы результата.
`data.blockIds`	integer[]	ID блоков в перечитанном порядке страницы.

Ответ

JSON

{
  "success": true,
  "data": {
    "pageId": 42,
    "blockIds": [
      31,
      32
    ]
  }
}

Ошибки

HTTP	Код	Причина
400	`INVALID_PARAMS`	Некорректный ID, тело или блок после которого вставлять.
400	`MISSING_REQUIRED_FIELDS`	Нет обязательного поля.
403	`SCOPE_DENIED / WRITE_BLOCKED_READONLY_KEY`	Нет landing или ключ только для чтения.
409	`LANDING_MODULE_NOT_ENABLED`	Модуль Сайты недоступен на портале.
404	`ENTITY_NOT_FOUND`	Нет страницы или блок не принадлежит исходной странице.
422	`BITRIX_ERROR / BITRIX_NO_EFFECT`	Отказ Б24 или результат не подтверждён; не повторяйте удаление вслепую.
409	`BLOCK_WRONG_SORT`	Граница порядка.

Общие ошибки.

Каждый ответ Б24 ограничен 8 МиБ; превышение даёт 502. После неподтверждённого результата не повторяйте действие вслепую: copy может создать ещё один блок, up/down изменят порядок повторно.