#Обновить страницу

PATCH /v1/pages/:id

Обновляет поля существующей страницы. Передавайте только изменяемые поля плоско в корне JSON — без обёртки fields. Не переданные поля сохраняют текущие значения.

#Параметры

Параметр Тип Обяз. Описание
id (path) number да Идентификатор страницы

#Поля для обновления (body)

Поле Тип Описание
title string Название страницы, до 255 символов
code string Символьный код страницы. Не должен содержать /. Если код уже занят на сайте — добавляется числовой суффикс
description string Произвольное описание
siteId number Перенести страницу на другой сайт. Список сайтов: `GET /v1/sites`

#Примеры

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

Terminal 
curl -X PATCH "https://vibecode.bitrix24.tech/v1/pages/2295" \
  -H "X-Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Весенняя акция — обновлено",
    "description": "Скидки до 50%"
  }'

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

Terminal 
curl -X PATCH "https://vibecode.bitrix24.tech/v1/pages/2295" \
  -H "X-Api-Key: YOUR_APP_KEY" \
  -H "Authorization: Bearer USER_SESSION_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Весенняя акция — обновлено",
    "description": "Скидки до 50%"
  }'

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

javascript 
const res = await fetch('https://vibecode.bitrix24.tech/v1/pages/2295', {
  method: 'PATCH',
  headers: {
    'X-Api-Key': 'YOUR_API_KEY',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    title: 'Весенняя акция — обновлено',
    description: 'Скидки до 50%',
  }),
})

const { success, data } = await res.json()

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

javascript 
const res = await fetch('https://vibecode.bitrix24.tech/v1/pages/2295', {
  method: 'PATCH',
  headers: {
    'X-Api-Key': 'YOUR_APP_KEY',
    'Authorization': 'Bearer USER_SESSION_TOKEN',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    title: 'Весенняя акция — обновлено',
    description: 'Скидки до 50%',
  }),
})

const { success, data } = await res.json()

#Поля ответа

Возвращается полный объект обновлённой страницы.

Поле Тип Описание
id number Идентификатор страницы
title string Название страницы
code string Символьный код страницы
siteId number Идентификатор сайта
active boolean Активна ли страница
description string | null Описание страницы
createdById number Идентификатор создавшего сотрудника
dateCreate datetime Дата создания
dateModify datetime Дата последнего изменения (после обновления)

#Пример ответа

JSON 
{
  "success": true,
  "data": {
    "id": 2295,
    "title": "Весенняя акция — обновлено",
    "code": "spring-sale",
    "siteId": 3,
    "active": false,
    "description": "Скидки до 50%",
    "createdById": 1,
    "dateCreate": "2026-05-08T11:49:33.000Z",
    "dateModify": "2026-05-08T12:14:08.000Z"
  }
}

#Пример ответа при ошибке

422 — слеш в code:

JSON 
{
  "success": false,
  "error": {
    "code": "BITRIX_ERROR",
    "message": "Слеш запрещен в адресе лендинга."
  }
}

#Ошибки

HTTP error.code Маркер в error.message Описание
401 TOKEN_MISSING — API-ключ не имеет настроенных токенов
403 BITRIX_ACCESS_DENIED — У пользователя нет права на изменение этой страницы
403 SCOPE_DENIED — API-ключ не имеет скоупа landing
404 ENTITY_NOT_FOUND — Страница с таким id не найдена или удалена
422 BITRIX_ERROR Слеш запрещен в адресе лендинга В code передан символ /
422 BITRIX_ERROR Адрес страницы не может быть пустым В code передана пустая строка
422 BITRIX_ERROR Недопустимый адрес страницы В code передано значение в формате __

Полный список общих ошибок API — Ошибки.

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