Configuración

Get the brand kit

branding.settings.get

Returns the organization's brand kit, what the white-label app, the login, the emails and the PDF reports show: app_name, logo, logo_dark, logo_icon, favicon, report_logo (images), primary_color, accent_color, brand_colors (hex colors), heading_font and body_font (email-safe fonts), button_shape (square, rounded, pill), button_style (filled, outlined), button_color and button_text_color, plus heading_font_name and body_font_name (the short names of the font stacks), configured_at, configured_by and configured_by_name (who saved it last). Image fields are absolute URLs. It reads the organization as it is now (not a copy kept for a few seconds), so a write is visible right away. settings is the organization's own kit (null when it never set one; configured says whether it has anything), and effective_settings what is actually shown: an Account without a kit of its own shows its workspace's (inherited_from_parent true). Addresses (domains, subdomains) are in branding.domains.get; the sending domain in branding.email_domain.get. Requires view access to Branding.

Alcance

branding:read

Permiso

Ver el módulo

Tool del MCP

branding_settings_getEn la superficie completa; en la compacta, mb_execute_operation con id: "branding.settings.get".

Costo declarado: hasta 3 lecturas y 0 escrituras por llamada (cuentan en el cupo diario).

Parámetros

Sin parámetros.

Respuesta

Errores

Ejemplo

curl "https://api.mb-suite.com/v1/branding/settings" \
  -H "Authorization: Bearer $MB_API_KEY"

Probar con tu API key de prueba

Con una API key de prueba el pedido va siempre a tu organización de práctica: datos de ejemplo que puedes reiniciar.

curl "https://api.mb-suite.com/v1/branding/settings" \
  -H "Authorization: Bearer $MB_TEST_KEY"

Update the brand kit

branding.settings.update

Changes one or more fields of the brand kit, sent inside updates: app_name, logo, logo_dark, logo_icon, favicon, report_logo (images), primary_color, accent_color, brand_colors (hex colors), heading_font and body_font (email-safe fonts), button_shape (square, rounded, pill), button_style (filled, outlined), button_color and button_text_color. Only what is sent changes; null (or an empty string) clears a field; brand_colors replaces the whole list ([] empties it, up to 50 colors); app_name up to 100 characters; colors must be CSS hex (#RGB, #RRGGBB, #RRGGBBAA); fonts by name (Helvetica, Arial, Georgia, Times New Roman, Courier New, Verdana, Tahoma, Trebuchet MS, Lucida Sans, Impact) or by the exact stack branding.settings.get returns (anything else: 400 branding_font_invalid). An image is the https URL of a PNG, JPG, WebP, GIF or SVG: MB Suite downloads it, normalizes it and keeps its own copy (the external link is never stored); a URL that could not be downloaded leaves that field as it was and comes back in skipped_images. A URL that branding.settings.get returned for this organization is accepted as is; one from another organization's storage is rejected (400 branding_image_invalid). Unknown fields are rejected. Sending the same values changes nothing (changed_fields empty). Each change fires branding.settings.updated. Returns the kit as saved. Owners and admins with edit access to Branding.

Alcance

branding:write

Permiso

Editar en el módulo · Solo owner, admin

Tool del MCP

branding_settings_updateEn la superficie completa; en la compacta, mb_execute_operation con id: "branding.settings.update".

Eventos que puede emitir

branding.settings.updated

Costo declarado: hasta 1 lecturas y 1 escrituras por llamada (cuentan en el cupo diario).

Parámetros

Respuesta

Errores

Ejemplo

curl -X PATCH "https://api.mb-suite.com/v1/branding/settings" \
  -H "Authorization: Bearer $MB_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "updates": {}
}'

Probar con tu API key de prueba

Con una API key de prueba el pedido va siempre a tu organización de práctica: datos de ejemplo que puedes reiniciar.

curl -X PATCH "https://api.mb-suite.com/v1/branding/settings" \
  -H "Authorization: Bearer $MB_TEST_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "updates": {}
}'

Reset a section of the brand kit

branding.settings.reset_section

Puts one section of the brand kit back to MB Suite's defaults by clearing its fields: colors (primary_color, accent_color, brand_colors), fonts (heading_font, body_font) or buttons (button_shape, button_style, button_color, button_text_color). Logos, favicon and app name are not touched (clear them with branding.settings.update). Returns cleared_fields and previous (the values that were cleared, by public name: send them back to branding.settings.update to undo). A section already at the defaults changes nothing (cleared_fields empty). Fires branding.settings.updated with reset_section. Owners and admins with edit access to Branding.

Alcance

branding:write

Permiso

Editar en el módulo · Solo owner, admin

Tool del MCP

branding_settings_reset_sectionEn la superficie completa; en la compacta, mb_execute_operation con id: "branding.settings.reset_section".

Eventos que puede emitir

branding.settings.updated

Costo declarado: hasta 1 lecturas y 1 escrituras por llamada (cuentan en el cupo diario).

Parámetros

Respuesta

Errores

Ejemplo

curl -X POST "https://api.mb-suite.com/v1/branding/settings/reset" \
  -H "Authorization: Bearer $MB_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
  "section": "colors"
}'

Probar con tu API key de prueba

Con una API key de prueba el pedido va siempre a tu organización de práctica: datos de ejemplo que puedes reiniciar.

curl -X POST "https://api.mb-suite.com/v1/branding/settings/reset" \
  -H "Authorization: Bearer $MB_TEST_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
  "section": "colors"
}'