Ir a la documentación
API

Cambiar las fuentes y el fondo de acceso

Cambia las fuentes, el fondo de la página de acceso o ambos, y devuelve la marca. Un campo que no se envía conserva su valor.

PATCH/branding

Ejecuta la llamada real en tu espacio de trabajo.

PATCH /branding

Cambia las fuentes, el fondo de la página de acceso o ambos, y devuelve la marca. Un campo que no se envía conserva su valor.

La solicitud

Parámetros

fontsobject
Las fuentes que se cambian, como `primary`, `secondary` o ambas. Cada una es un id de fuente o null para la predeterminada, y una fuente que no se envía conserva su valor.
loginBackgroundobject | null
El fondo de la página de acceso, que sustituye al que había, o null para el predeterminado. `kind` es `preset`, `color` o `image`. `preset` es uno de `dusk`, `mist`, `sand`, `night` y es obligatorio con `kind: "preset"`. `color` es `#` y seis dígitos hexadecimales y es obligatorio con `kind: "color"`. El valor del otro tipo también se puede enviar y se conserva, así que volver a él lo recupera.

Ejemplo

Necesita settings:write y una clave sin restricción de direcciones ni de dominios.

curl
curl -X PATCH "$OE/branding" -H "$AUTH" -H "Content-Type: application/json" \  -d '{ "loginBackground": { "kind": "color", "preset": "dusk", "color": "#1f2937" } }'
Respuesta
{  "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" muestra la foto subida con PUT /branding/images/login-background, y el fondo se lee como null hasta que se sube una. Subir una cambia la página a ella por sí solo.

Una fuente que no está en la lista, un fondo preset sin fondo predefinido o un color que no es # y seis dígitos hexadecimales responde 422 invalid_parameter, con param nombrando el campo. Un espacio personal responde 409 branding_unavailable.

Tu bandeja de entrada,
en tus propios términos.

Infraestructura de correo para empresas, IA, agentes y correo personal. Creada para escalar, con privacidad y control. Todo lo que el correo debería haber tenido desde el primer día.

© 2026 OpenEmail. Todos los derechos reservados.