Aller à la documentation
API

Téléverser une image de marque

Téléverse une image de marque, qui remplace celle qu'il y avait, et renvoie la marque. Le corps est l'image elle-même, pas du JSON.

PUT/branding/images/{variant}

Exécute le véritable appel sur votre espace de travail.

PUT /branding/images/{variant}

Téléverse une image de marque, qui remplace celle qu'il y avait, et renvoie la marque. Le corps est l'image elle-même, pas du JSON.

Les quatre images

variantCe que c'estFormatsStockée en
markL'icône carréeSVG, PNG, JPEG, WebPWebP, 512 sur 512 au maximum
wordmarkLe logoSVG, PNG, JPEG, WebPWebP, 1024 sur 256 au maximum
wordmark-darkLe logo pour le mode sombreSVG, PNG, JPEG, WebPWebP, 1024 sur 256 au maximum
login-backgroundLa photo derrière la page de connexionPNG, JPEG, WebP, GIFWebP, 2560 sur 1600 au maximum

Envoyez les octets avec leur type dans Content-Type. Jusqu'à 5 Mo sont acceptés. Un SVG est converti en image, et une image animée garde sa première image.

Exemple

Nécessite settings:write et une clé sans restriction d'adresse ni de domaine.

curl
curl -X PUT "$OE/branding/images/login-background" -H "$AUTH" \  -H "Content-Type: image/jpeg" --data-binary @lobby.jpg
Réponse
{  "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": "https://cdn-prod.openemail.uk/workspaces/login-backgrounds/0199a1c3-0f2e-7c61-8d4a-5b1e9f7a2c36.webp"  },  "fonts": {    "primary": "inter",    "secondary": "georgia"  },  "loginBackground": {    "kind": "image",    "preset": "dusk",    "color": null  }}

Téléverser la photo de connexion bascule aussi la page de connexion dessus.

Une image d'un type que cette variante n'accepte pas, ou illisible, répond 422 invalid_image. Un service d'images occupé répond 503 image_busy, et un enregistrement échoué 502 image_not_stored, donc réessayez.

Votre boîte de réception,
à vos conditions.

L’infrastructure e-mail pour les entreprises, l’IA, les agents et le courrier personnel. Conçue pour l’échelle, la confidentialité et le contrôle. Tout ce que l’e-mail aurait dû avoir dès le premier jour.

© 2026 OpenEmail. Tous droits réservés.