Menú

Referencia de la API · Client Portal

Configuración

client_portal · settings · 2 operaciones

GET/v1/client-portal/settings

Get the client portal settings

client_portal.settings.get

LecturaIdempotenteDesde 2026-11-01

Returns this workspace's client portal setup: name (the portal's own or the organization's), logo, logo_dark and favicon (absolute URLs), slug (the <slug>.mb-suite.com subdomain) and subdomain_enabled, the custom domain with domain_verified and domain_enabled, configured (false while there is no subdomain: clients cannot be invited until there is one) and urls (the addresses clients use today, custom domain first). Only owners and admins.

Alcance
client_portal:read
Permiso
Ver el módulo · Solo owner, admin
Tool del MCP
client_portal_settings_getEn la superficie completa; en la compacta, mb_execute_operation con id: "client_portal.settings.get".

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

Parámetros

Sin parámetros.

Respuesta

namestring

The portal's name (its own or the organization's).

logostring | null

The logo (an absolute URL).

logo_darkstring | null

The logo for dark backgrounds (an absolute URL).

faviconstring | null

The browser icon (an absolute URL).

slugstring | null

The subdomain label (<slug>.mb-suite.com); null while there is none.

subdomain_enabledboolean

True when the subdomain is on.

domainstring | null

The custom domain, if any.

domain_verifiedboolean

True when the custom domain's DNS is verified.

domain_enabledboolean

True when the custom domain is on.

configuredboolean

False while there is no subdomain: clients cannot be invited until there is one.

urlsarray<string>

The addresses clients use today (custom domain first).

Errores

Ejemplo

curl "https://api.mb-suite.com/v1/client-portal/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/client-portal/settings" \
  -H "Authorization: Bearer $MB_TEST_KEY"
PATCH/v1/client-portal/settings

Rename the portal or turn its addresses on or off

client_portal.settings.update

EscrituraIdempotenteDesde 2026-11-01

Edits the client portal settings that do not touch another platform: updates.name (portal name in the browser tab, the login page and invitation emails), updates.subdomain_enabled and updates.domain_enabled (turn the <slug>.mb-suite.com address or the custom domain on or off; turning one on requires it to exist: portal_subdomain_not_set / portal_domain_not_set, 409). With an address off, clients see an «unavailable» page there; the change can take up to 5 minutes to show. Adding, changing or removing the subdomain or the custom domain is branding.portal_domains.add / branding.portal_domains.remove (and verifying the domain, branding.portal_domains.verify); the logos and the favicon are uploaded in the app. Returns the settings and changed_fields (empty when nothing changed). Only owners and admins.

Alcance
client_portal:write
Permiso
Editar en el módulo · Solo owner, admin
Tool del MCP
client_portal_settings_updateEn la superficie completa; en la compacta, mb_execute_operation con id: "client_portal.settings.update".

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

Parámetros

updatesobjectcuerporequerido

What changes (name, subdomain_enabled, domain_enabled): only the fields sent.

Respuesta

settingsobject
changed_fieldsarray<string>

Errores

Ejemplo

curl -X PATCH "https://api.mb-suite.com/v1/client-portal/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/client-portal/settings" \
  -H "Authorization: Bearer $MB_TEST_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "updates": {}
}'