Modifier les polices et le fond de connexion
Modifie les polices, le fond de la page de connexion ou les deux, et renvoie la marque. Un champ omis garde sa valeur.
Exécute le véritable appel sur votre espace de travail.
PATCH /branding
Modifie les polices, le fond de la page de connexion ou les deux, et renvoie la marque. Un champ omis garde sa valeur.
La requête
Paramètres
fontsobject- Les polices à modifier, en `primary`, `secondary` ou les deux. Chacune est un identifiant de police ou null pour celle par défaut, et une police omise garde sa valeur.
loginBackgroundobject | null- Le fond de la page de connexion, qui remplace celui qu'il y avait, ou null pour celui par défaut. `kind` vaut `preset`, `color` ou `image`. `preset` est l'un de `dusk`, `mist`, `sand`, `night` et est requis pour `kind: "preset"`. `color` est `#` suivi de six chiffres hexadécimaux et est requis pour `kind: "color"`. La valeur de l'autre type peut aussi être envoyée et elle est conservée, donc revenir à ce type la restaure.
Exemple
Nécessite settings:write et une clé sans restriction d'adresse ni de domaine.
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" affiche la photo téléversée avec PUT /branding/images/login-background, et le fond se lit comme null tant qu'aucune ne l'est. En téléverser une bascule la page dessus d'elle-même.
Une police absente de la liste, un fond preset sans fond prédéfini ou une couleur qui n'est pas # suivi de six chiffres hexadécimaux répond 422 invalid_parameter, et param nomme le champ. Un espace personnel répond 409 branding_unavailable.
