Asignaciones

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).

Alcance

monitors:read

Permiso

Ver el módulo

Tool del MCP

monitors_assignments_listEn la superficie completa; en la compacta, mb_execute_operation con id: "monitors.assignments.list".

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

Parámetros

Sin parámetros.

Respuesta

Errores

Ejemplo

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

Alcance

monitors:read

Permiso

Ver el módulo

Tool del MCP

monitors_assignments_getEn la superficie completa; en la compacta, mb_execute_operation con id: "monitors.assignments.get".

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

Parámetros

Respuesta

Errores

Ejemplo

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

Alcance

monitors:write

Permiso

Editar en el módulo

Tool del MCP

monitors_assignments_setEn la superficie completa; en la compacta, mb_execute_operation con id: "monitors.assignments.set".

Eventos que puede emitir

monitors.monitor.assigned

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

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/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.

Alcance

monitors:write

Permiso

Editar en el módulo

Tool del MCP

monitors_assignments_clearEn la superficie completa; en la compacta, mb_execute_operation con id: "monitors.assignments.clear".

Eventos que puede emitir

monitors.monitor.unassigned

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