Поменять меню

1. Что стоит сейчас

curl -s -H "Authorization: Bearer $OP_TOKEN" "$API/site/$SITE/menus" \
  | jq -c '.menus[] | select(.assigned | length > 0) | {id, slug, name, assigned}'

{"id":83,"slug":"header-en","name":"header en","assigned":[{"location":"header","lang":"en"}]}
{"id":107,"slug":"header-ru","name":"header ru","assigned":[{"location":"header","lang":"ru"}]}
{"id":143,"slug":"footer-docs-en","name":"Документация","assigned":[{"location":"footer_1","lang":"en"}]}

Пункты меню шапки на нужном языке:

curl -s -H "Authorization: Bearer $OP_TOKEN" "$API/site/$SITE/data/menu.header?lang=ru" \
  | jq -c '{menu: .meta.menu_id, invalid: .meta.invalid_items, items: [.items[] | {id, title, url, children: (.children | length)}]}'

invalid_items больше нуля — в меню есть пункты на удалённые или неопубликованные страницы, посетитель их не видит.

2. Заменить пункты целиком

Самый надёжный путь — прислать дерево, каким оно должно стать. Адрес меню ~header означает «меню, стоящее в шапке», lang выбирает язык:

curl -s -X PUT "$API/site/$SITE/menus/~header/items" \
  -H "Authorization: Bearer $OP_TOKEN" -H 'Content-Type: application/json' \
  -d '{"lang": "ru", "items": [
        {"page": "/docs/", "title": "Документация", "children": [
          {"page": "/docs/v2/ru/guides/quickstart/"},
          {"page": "/docs/v2/ru/reference/"}
        ]},
        {"page": "/tarify/"},
        {"url": "https://example.com", "title": "Партнёры", "target": "_blank"}
      ]}' | jq -c '{menu, total, invalid, rebaked: .rebaked.status}'

Меню другого языка не затрагивается. Страницы — {"page": …} (id, слаг или путь), внешние адреса — {"url": …}. Ссылка на несуществующую страницу отменит запрос целиком (409 menu_items_unresolved, ничего не записано), на неопубликованную — тоже (409 menu_items_invalid), пока не добавить "allow_invalid": true.

То же одной записью в источник: PUT $API/site/$SITE/data/menu.header с тем же телом.

3. Или точечно

# добавить пункт в конец
curl -s -X POST "$API/site/$SITE/menus/~header/items" \
  -H "Authorization: Bearer $OP_TOKEN" -H 'Content-Type: application/json' \
  -d '{"lang": "ru", "item": {"page": "/blog/", "title": "Блог"}}' | jq -c .item

# переименовать пункт (id — из шага 1)
curl -s -X PATCH "$API/site/$SITE/menus/~header/items/6301" \
  -H "Authorization: Bearer $OP_TOKEN" -H 'Content-Type: application/json' \
  -d '{"lang": "ru", "title": "Доки"}' | jq -c .item

# переставить пункты верхнего уровня
curl -s -X POST "$API/site/$SITE/menus/~header/reorder" \
  -H "Authorization: Bearer $OP_TOKEN" -H 'Content-Type: application/json' \
  -d '{"lang": "ru", "order": [6303, 6301], "parent": 0}' | jq -c '{order, appended}'

# убрать пункт вместе с вложенными
curl -s -X DELETE "$API/site/$SITE/menus/~header/items/6302" \
  -H "Authorization: Bearer $OP_TOKEN" -H 'Content-Type: application/json' \
  -d '{"lang": "ru"}' | jq -c '{removed, total}'

4. Меню в новой области

Подвала ещё нет — создайте меню сразу в области:

curl -s -X POST "$API/site/$SITE/menus" \
  -H "Authorization: Bearer $OP_TOKEN" -H 'Content-Type: application/json' \
  -d '{"name": "Продукт", "location": "footer_1", "lang": "ru", "items": [{"page": "/tarify/"}, {"page": "/docs/"}]}' \
  | jq -c '{menu, invalid}'

Имя меню становится заголовком колонки во фрейме footer-columns. Переименовать — PATCH /menus/{ref} с name.

5. Проверить

curl -s "https://ВАШ_ДОМЕН/" | grep -o '<ul id="menu-[^"]*" class="[^"]*"'
curl -s "https://ВАШ_ДОМЕН/" | grep -o 'menu-item-[0-9]*"><a href="[^"]*">[^<]*' | head

Каждая запись меню сама пересобирает фреймы с меню и сбрасывает кэш их страниц — изменения видны на следующем запросе. Меню не появилось:

вызов frame/menu во фрейме смотрит в другую область (place);
меню поставлено на другом языке — у страницы свой язык;
все пункты битые — invalid_items в источнике;
theme в GET /menus не совпадает с темой сайта — меню поставлены в карту другой темы.