Modo de conexão

Choose own or inherited connection for a platform

integrations.platform_mode.change

In an Account, chooses whether a platform uses the Account's own connection (mode own) or its workspace's (mode inherited). In an Account managed or paid by the workspace, the workspace's owners and admins decide (403 role_required, details.scope workspace); in an Account that pays for itself, its own owners and admins (403 role_required, details.scope direct), and inherited only makes the platform available: the workspace then connects it (integrations.inheritance.activate). Switching from inherited to own unlinks the platform's inherited accounts (cleaned_platforms). Choosing the current mode changes nothing (changed: false). Errors: 400 not_an_account in a workspace, 409 billing_mode_not_supported in an independent Account.

Escopo

integrations:write

Permissão

Editar no módulo

Tool do MCP

integrations_platform_mode_changeNa superfície completa; na compacta, mb_execute_operation com id: "integrations.platform_mode.change".

Eventos que pode emitir

integrations.data_source.unlinked

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

Parâmetros

Resposta

Erros

Exemplo

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

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/integrations/platforms/{platform}/mode" \
  -H "Authorization: Bearer $MB_TEST_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
  "mode": "own"
}'