Subir una imagen de marca
Sube una imagen de marca, que sustituye a la que había, y devuelve la marca. El cuerpo es la propia imagen, no JSON.
Ejecuta la llamada real en tu espacio de trabajo.
PUT /branding/images/{variant}
Sube una imagen de marca, que sustituye a la que había, y devuelve la marca. El cuerpo es la propia imagen, no JSON.
Las cuatro imágenes
| variant | Qué es | Formatos | Se guarda como |
|---|---|---|---|
| mark | El icono cuadrado | SVG, PNG, JPEG, WebP | WebP, como máximo 512 por 512 |
| wordmark | El logo | SVG, PNG, JPEG, WebP | WebP, como máximo 1024 por 256 |
| wordmark-dark | El logo para el modo oscuro | SVG, PNG, JPEG, WebP | WebP, como máximo 1024 por 256 |
| login-background | La foto detrás de la página de acceso | PNG, JPEG, WebP, GIF | WebP, como máximo 2560 por 1600 |
Envía los bytes con su tipo en Content-Type. Se aceptan hasta 5 MB. Un SVG se convierte en una imagen, y una imagen animada conserva su primer fotograma.
Ejemplo
Necesita settings:write y una clave sin restricción de direcciones ni de dominios.
curl -X PUT "$OE/branding/images/login-background" -H "$AUTH" \ -H "Content-Type: image/jpeg" --data-binary @lobby.jpg{ "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 }}Subir la foto de acceso también cambia la página de acceso a ella.
Una imagen de un tipo que esa variante no acepta, o que no se puede leer, responde 422 invalid_image. Un servicio de imágenes ocupado responde 503 image_busy, y un guardado fallido 502 image_not_stored, así que vuelve a intentarlo.
