Atribuições

List the monitor assigned to each platform

monitors.assignments.list

Lists the platform tabs of this organization's Monitors page that have a monitor assigned: one item per platform, in the screen's order, with the template, where it comes from (its own ORGANIZATION template, an INHERITED one from the workspace or a SYSTEM monitor), whether the template is still available (it exists, is published and is built for that platform; when it is not, the tab shows the monitor picker) and whether the platform is connected (without a connection the tab is hidden). Platforms with no monitor are not listed; the list is always whole (one item per platform, up to 12). Each item says who assigned it (created_by, created_by_name) and who changed it last. For an account, call it on the account (org_id).

Escopo

monitors:read

Permissão

Ver o módulo

Tool do MCP

monitors_assignments_listNa superfície completa; na compacta, mb_execute_operation com id: "monitors.assignments.list".

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

Parâmetros

Sem parâmetros.

Resposta

Erros

Exemplo

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

Get the monitor assigned to a platform

monitors.assignments.get

Returns the monitor assigned to one platform tab of this organization (platform_id is one of the platforms with a monitor tab, such as google_ads or meta_ads): the template, its source, whether it is still available and whether the platform is connected. Not found (monitor_assignment_not_found) when that tab has no monitor.

Escopo

monitors:read

Permissão

Ver o módulo

Tool do MCP

monitors_assignments_getNa superfície completa; na compacta, mb_execute_operation com id: "monitors.assignments.get".

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

Parâmetros

Resposta

Erros

Exemplo

curl "https://api.mb-suite.com/v1/monitors/assignments/{platform_id}" \
  -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/monitors/assignments/{platform_id}" \
  -H "Authorization: Bearer $MB_TEST_KEY"

Assign a monitor to a platform

monitors.assignments.set

Shows a monitor template in one platform tab of this organization's Monitors page, replacing the one it had. The template must be reachable (the organization's own, a published one of its workspace for an account, or a published system monitor; source narrows where to look), published (template_not_published otherwise) and built for that platform (template_platform_mismatch otherwise). The tab can be assigned before the platform is connected; it shows once there is a connection. Idempotent: assigning the same monitor again changes nothing (changed false). Returns the assignment. Requires edit access to Monitors.

Escopo

monitors:write

Permissão

Editar no módulo

Tool do MCP

monitors_assignments_setNa superfície completa; na compacta, mb_execute_operation com id: "monitors.assignments.set".

Eventos que pode emitir

monitors.monitor.assigned

Custo declarado: até 4 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/monitors/assignments/{platform_id}" \
  -H "Authorization: Bearer $MB_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
  "template_id": "TEMPLATE_ID"
}'

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/monitors/assignments/{platform_id}" \
  -H "Authorization: Bearer $MB_TEST_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
  "template_id": "TEMPLATE_ID"
}'

Remove the monitor from a platform

monitors.assignments.clear

Removes the monitor assigned to one platform tab of this organization: the tab goes back to the monitor picker. The template itself is not touched and can be assigned again with monitors.assignments.set. Idempotent: on a tab with no monitor nothing changes (cleared false). Requires edit access to Monitors.

Escopo

monitors:write

Permissão

Editar no módulo

Tool do MCP

monitors_assignments_clearNa superfície completa; na compacta, mb_execute_operation com id: "monitors.assignments.clear".

Eventos que pode emitir

monitors.monitor.unassigned

Custo declarado: até 1 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/monitors/assignments/{platform_id}/clear" \
  -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 -X POST "https://api.mb-suite.com/v1/monitors/assignments/{platform_id}/clear" \
  -H "Authorization: Bearer $MB_TEST_KEY"