Стили блока

PATCH /v1/pages/:pageId/blocks/:blockId/styles

classList заменяет список классов. Классы, по которым узел адресуется в манифесте, автоматически сохраняются, чтобы следующие правки, в том числе в этом же запросе, могли найти узел. style содержит свойства оформления. Ответ содержит перечитанный HTML.

Пересекающиеся .class и .class@N применяются в порядке полей запроса. Если развёртка сталкивается по индексу, обёртка делает несколько последовательных вызовов Б24; ошибка позднего вызова не откатывает предыдущие изменения.

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

Параметры

pageId и blockId: положительные целые безопасные числа; блок должен принадлежать странице. Необязательный query scope=KNOWLEDGE|GROUP|MAINPAGE для контекста страницы.

Селектор: .class или .class@N, индекс с нуля. Набор не может быть пустым. Доступные селекторы берите из манифеста блока; ошибка неизвестного селектора содержит доступные селекторы.

Пример

curl -X PATCH "https://vibecode.bitrix24.tech/v1/pages/42/blocks/7/styles" \
  -H "X-Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"styles":{".landing-block-node-title":{"classList":["g-color-red"]}}}'

Ответ

{
  "success": true,
  "data": {
    "id": 7,
    "pageId": 42,
    "anchor": "chapter",
    "content": "<h2 class=\"landing-block-node-title\">Title</h2>",
    "nodes": {},
    "styles": {},
    "attrs": {},
    "cards": {},
    "active": true
  }
}

HTML — строка данных: при отображении используйте санитайзер. Отсутствующие в ответе Б24 nodes/styles/attrs/cards возвращаются пустыми объектами; сохранённые значения видны в content.

Ошибки

400 INVALID_PARAMS / MISSING_REQUIRED_FIELDS / INVALID_SCOPE; 403 SCOPE_DENIED / WRITE_BLOCKED_READONLY_KEY; 404 ENTITY_NOT_FOUND; 409 LANDING_MODULE_NOT_ENABLED / PORTAL_ADDRESS_CHANGED; 422 BITRIX_ERROR; 429, 502, 503.