Изменить шрифты и фон страницы входа
Меняет шрифты, фон страницы входа или и то и другое и возвращает бренд. Пропущенное поле сохраняет своё значение.
Выполняет настоящий запрос в вашем рабочем пространстве.
PATCH /branding
Меняет шрифты, фон страницы входа или и то и другое и возвращает бренд. Пропущенное поле сохраняет своё значение.
Запрос
Параметры
fontsobject- Шрифты для изменения: `primary`, `secondary` или оба. Каждый задаётся идентификатором шрифта или null для значения по умолчанию, а пропущенный шрифт сохраняет своё значение.
loginBackgroundobject | null- Фон страницы входа, заменяющий прежний, или null для фона по умолчанию. `kind` равно `preset`, `color` или `image`. `preset` принимает одно из значений `dusk`, `mist`, `sand`, `night` и обязательно при `kind: "preset"`. `color` состоит из `#` и шести шестнадцатеричных цифр и обязательно при `kind: "color"`. Значение для другого вида тоже можно передать, оно сохраняется, так что при возврате к нему оно восстанавливается.
Пример
Требуется settings:write и ключ без ограничения по адресам или доменам.
curl -X PATCH "$OE/branding" -H "$AUTH" -H "Content-Type: application/json" \ -d '{ "loginBackground": { "kind": "color", "preset": "dusk", "color": "#1f2937" } }'{ "object": "branding", "editable": true, "images": { "mark": "https://cdn-prod.openemail.uk/workspaces/icons/0199a1c2-7d4e-7a31-9b52-3c8e1f0a6d24.webp", "wordmark": "https://cdn-prod.openemail.uk/workspaces/wordmarks/0199a1c2-8b10-7e45-a2f1-6d9c3b7e0f58.webp", "wordmarkDark": null, "loginBackground": null }, "fonts": { "primary": "inter", "secondary": "georgia" }, "loginBackground": { "kind": "color", "preset": "dusk", "color": "#1f2937" }}kind: "image" показывает фото, загруженное через PUT /branding/images/login-background, а пока его нет, фон читается как null. Загрузка фото сама переключает страницу на него.
Шрифт не из списка, фон preset без указанного готового фона или цвет, который не состоит из # и шести шестнадцатеричных цифр, получают ответ 422 invalid_parameter, а param называет поле. Личное пространство получает 409 branding_unavailable.
