MB SuiteMB Suite
Menu

Referência da API · Perfil

Slug

profile · slug · 2 operações

GET/v1/profile/slug/availabilityPOST/v1/profile/slug
GET/v1/profile/slug/availability

Check whether a slug is available

profile.slug.check

LeituraIdempotenteDesde 2026-11-01

Says whether a slug can be used by this organization: available true when it is free or is already this organization's slug (current true), or available false with reason and message: required, too_short, too_long, format (3 to 48 lowercase letters, digits and hyphens, not starting or ending with a hyphen), reserved (words MB Suite uses in its own addresses) or taken (another organization has it: slugs are unique across MB Suite). It changes nothing. Use it before profile.slug.update. Requires view access to the Profile module.

Escopo
profile:read
Permissão
Ver o módulo
Tool do MCP
profile_slug_checkNa superfície completa; na compacta, mb_execute_operation com id: "profile.slug.check".

Custo declarado: até 2 leituras e 0 escritas por chamada (contam na cota diária).

Parâmetros

slugstringqueryobrigatório

The slug: 3 to 48 lowercase letters, digits and hyphens, not starting or ending with a hyphen.

Resposta

slugstring
availableboolean
currentboolean

true when it is already this organization's slug.

reasonenum | null

Valores: required, too_short, too_long, format, reserved, taken

messagestring | null

Erros

invalid_inputunknown_fieldauthentication_requiredscope_insufficientmodule_access_deniedoperation_not_foundrate_limitedquota_exceeded

Exemplo

curl "https://api.mb-suite.com/v1/profile/slug/availability?slug=SLUG" \
  -H "Authorization: Bearer $MB_API_KEY"

Testar com a sua API key de teste

Com uma API key de teste o pedido vai sempre para a sua organização de prática: dados de exemplo que você pode reiniciar.

curl "https://api.mb-suite.com/v1/profile/slug/availability?slug=SLUG" \
  -H "Authorization: Bearer $MB_TEST_KEY"
POST/v1/profile/slug

Change the organization's slug

profile.slug.update

EscritaIdempotenteDesde 2026-11-01

Changes the organization's slug, its identifier in the app's addresses (mb-suite.com/<slug>/…) and in the public booking pages of the main domain (mb-suite.com/book/<slug>/…). Every link with the old slug stops working and the old slug becomes available to other organizations; custom domains keep working. Validates like the screen: 400 invalid_slug with details.reason (required, too_short, too_long, format, reserved) and 409 slug_taken when another organization uses it; the uniqueness check and the change are atomic. Sending the current slug changes nothing (changed false). dry_run=true runs the same validations and says what would change without changing it; its preview says needs_confirmation false: running it does not need the confirm_token the dry run returns. Fires profile.slug.changed. Returns slug, previous_slug and changed. Owners and admins only (of the organization or, on an Account, of its workspace).

Instruções para agentes

Confirm the change with the person first: every link with the old slug (app bookmarks, public booking links on mb-suite.com) stops working and someone else can take the old slug.

Escopo
profile:write
Permissão
Editar no módulo · Só owner, admin
Tool do MCP
profile_slug_updateNa superfície completa; na compacta, mb_execute_operation com id: "profile.slug.update".
Eventos que pode emitir
profile.slug.changed

Custo declarado: até 4 leituras e 3 escritas por chamada (contam na cota diária).

Parâmetros

slugstringcorpoobrigatório

The slug: 3 to 48 lowercase letters, digits and hyphens, not starting or ending with a hyphen.

Resposta

slugstring
previous_slugstring
changedboolean

Erros

role_requiredinvalid_inputunknown_fieldauthentication_requiredscope_insufficientcrm_action_deniedidempotency_key_reusedrate_limitedquota_exceeded

Exemplo

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

Testar com a sua API key de teste

Com uma API key de teste o pedido vai sempre para a sua organização de prática: dados de exemplo que você pode reiniciar.

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