Subdominio

Set the team's MB Suite subdomain

branding.subdomain.set

Sets or replaces the organization's MB Suite subdomain for team access: subdomain is only the label (youragency for youragency.mb-suite.com), 3 to 63 lowercase letters, digits or hyphens, not a reserved one (api, mcp, app, www, admin, portal…: 400 subdomain_reserved) and not used by another organization nor by this organization's client portal (409 domain_unavailable). It is registered with the hosting provider and enabled right away; no DNS to configure. Replacing an existing subdomain registers the new one before releasing the old one (fires branding.domain.removed for it). The same label again changes nothing, except turning it on if it was off. Fires branding.domain.added. Owners and admins with edit access to Branding.

Pide confirmación: primero dry_run: true (vista previa y confirm_token, que vale 10 minutos y una sola vez), después el mismo cuerpo con confirm_token. En unas pocas, solo con ciertos datos: la descripción dice cuándo. Por qué y cómo: Vista previa y confirmación.

Alcance

branding:write

Permiso

Editar en el módulo · Solo owner, admin

Tool del MCP

branding_subdomain_setEn la superficie completa; en la compacta, mb_execute_operation con id: "branding.subdomain.set".

Eventos que puede emitir

branding.domain.addedbranding.domain.removed

Costo declarado: hasta 31 lecturas y 1 escrituras por llamada (cuentan en el cupo diario). Toca una plataforma externa (vercel): cuenta en el cupo de operaciones externas.

Parámetros

Respuesta

Errores

Ejemplo

curl -X POST "https://api.mb-suite.com/v1/branding/subdomain" \
  -H "Authorization: Bearer $MB_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "subdomain": "SUBDOMAIN",
  "dry_run": true
}'

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. En la práctica esta operación no se simula (toca otra plataforma): responde 409 sandbox_external_unavailable.

Turn the team's subdomain on or off

branding.subdomain.toggle

Turns the team's MB Suite subdomain on (enabled true) or off without removing it: off, the address stops opening the white-label app but stays reserved for the organization. Already in that state, nothing changes (changed false). Not found without a subdomain. Owners and admins with edit access to Branding.

Alcance

branding:write

Permiso

Editar en el módulo · Solo owner, admin

Tool del MCP

branding_subdomain_toggleEn la superficie completa; en la compacta, mb_execute_operation con id: "branding.subdomain.toggle".

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/subdomain/toggle" \
  -H "Authorization: Bearer $MB_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
  "enabled": true
}'

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/subdomain/toggle" \
  -H "Authorization: Bearer $MB_TEST_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
  "enabled": true
}'

Remove the team's subdomain

branding.subdomain.remove

Removes the team's MB Suite subdomain: it stops opening MB Suite, it is released from the hosting provider (released_from_hosting false if the provider failed: the organization is cleaned anyway) and the label becomes available to other organizations. There is no trash: to undo, set it again with branding.subdomain.set (if nobody took it in between). Not found without a subdomain. Outside the app it needs a dry run and its confirm_token. Fires branding.domain.removed. Owners and admins with edit access to Branding.

Pide confirmación: primero dry_run: true (vista previa y confirm_token, que vale 10 minutos y una sola vez), después el mismo cuerpo con confirm_token. En unas pocas, solo con ciertos datos: la descripción dice cuándo. Por qué y cómo: Vista previa y confirmación.

Alcance

branding:write y «Permitir eliminar» (branding:delete en OAuth)

Permiso

Editar en el módulo · Solo owner, admin

Tool del MCP

branding_subdomain_removeEn la superficie completa; en la compacta, mb_execute_operation con id: "branding.subdomain.remove".

Eventos que puede emitir

branding.domain.removed

Costo declarado: hasta 16 lecturas y 1 escrituras por llamada (cuentan en el cupo diario). Toca una plataforma externa (vercel): cuenta en el cupo de operaciones externas.

Parámetros

Sin parámetros.

Respuesta

Errores

Ejemplo

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

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. En la práctica esta operación no se simula (toca otra plataforma): responde 409 sandbox_external_unavailable.