Menú

Referencia de la API · Monitors

Plantillas

monitors · templates · 8 operaciones

GET/v1/monitors/templates

List monitor templates

monitors.templates.list

LecturaIdempotenteDesde 2026-11-01

Lists the monitor templates this organization can use. A monitor is a one-page dashboard built for ONE platform and shown in that platform's tab of the Monitors page. Sources: the organization's own templates (ORGANIZATION, drafts included), the published templates of its workspace when it is an account (INHERITED) and the published system monitors (SYSTEM). Filter with source, platform (only templates that can be assigned to that platform's tab) and status. Each item has its platform, status, version (as stored; null when it has none), page and widget counts, and who created it (created_by, created_by_name); the description says what a system monitor shows (KPIs, Daily, Monthly…). Use monitors.templates.get for its widgets. Paginated by cursor (own templates first, by manual position).

Alcance: monitors:read
Permiso: Ver el módulo
Tool del MCP: monitors_templates_listEn la superficie completa; en la compacta, mb_execute_operation con id: "monitors.templates.list".

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

Parámetros

limitintegerqueryopcional

How many items this page brings at most (see the maximum and the default in the schema).

Por defecto: 50

cursorstringqueryopcional

The next_cursor of the previous page, exactly as it came (only for the same list and filters); without it, the first page.

sourceenumqueryopcional

Where from: ORGANIZATION (its own, drafts included), INHERITED (the published ones of its workspace, for an account), SYSTEM (MB Suite's published monitors) or all (default).

Valores: all, SYSTEM, ORGANIZATION, INHERITED · Por defecto: "all"

platformenumqueryopcional

Only the templates that can be assigned to this platform's tab.

Valores: google_analytics, google_ads, meta_ads, tiktok_ads, tiktok, instagram, facebook_page, youtube, google_search_console, google_business_profile, linkedin_ads, linkedin_page

statusenumqueryopcional

draft or published. Only the organization's own templates have drafts: draft lists only those.

Valores: draft, published

Respuesta

dataarray<object>

has_moreboolean

next_cursorstring

Errores

invalid_input unknown_field authentication_required scope_insufficient module_access_denied operation_not_found rate_limited quota_exceeded

Ejemplo

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

GET/v1/monitors/templates/{template_id}

Get one monitor template

monitors.templates.get

LecturaIdempotenteDesde 2026-11-01

Returns a monitor template with its platform, version (as stored; null when it has none), date range, filters and its page with a summary of each widget (type, title, metrics, dimensions, grid position; no numbers: those load when the monitor is opened in MB Suite). Without source it looks in the organization's own templates, then the workspace's published ones (for an account), then the published system monitors. Not found (monitor_template_not_found) if no reachable template has that id.

Alcance: monitors:read
Permiso: Ver el módulo
Tool del MCP: monitors_templates_getEn la superficie completa; en la compacta, mb_execute_operation con id: "monitors.templates.get".

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

Parámetros

template_idstringrutarequerido

The monitor template id (monitors.templates.list).

sourceenumqueryopcional

Where to look: ORGANIZATION, INHERITED or SYSTEM. Without it, the organization's own, then its workspace's published ones, then the system's.

Valores: SYSTEM, ORGANIZATION, INHERITED

Respuesta

idstring

Template id.

sourceenum

SYSTEM, ORGANIZATION or INHERITED (published by the workspace).

Valores: SYSTEM, ORGANIZATION, INHERITED

source_org_idstring | null

INHERITED: the workspace it belongs to.

titlestring

Title.

descriptionstring | null

Description.

subtitlestring | null

Subtitle.

statusenum

draft or published (accounts only see and deploy published ones).

Valores: draft, published

supported_platformsarray<string>

Platforms it is built for.

data_source_slotsarray<object>

Data slots a dashboard maps to its own sources.

default_data_sourcestring | null

The slot or platform widgets without a source use.

page_countnumber

How many pages.

widget_countnumber

How many widgets.

label_idsarray<string>

Template labels (dashboards.labels.list with of: templates).

positionnumber | null

Manual order in the list.

versionnumber | null

Template version (goes up by one with each update).

created_atnumber | null

Created (epoch ms).

updated_atnumber | null

Last edited (epoch ms).

created_bystring | null

Uid of who created it, or the system label that did.

pagesarray<object>

Pages with a summary of each widget.

date_rangeobject | null

The default period.

compare_date_rangeobject | null

The comparison period, if any.

filtersarray<object>

Global filters.

filter_controlsarray<any>

Filter controls shown to the viewer.

styleobject | null

Cover style.

platformstring | null

created_by_namestring | null

Their name («MB Suite» for the system).

raw_pagesarray<object>

Errores

invalid_input unknown_field authentication_required scope_insufficient module_access_denied operation_not_found rate_limited quota_exceeded

Ejemplo

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

POST/v1/monitors/templates

Create a monitor template

monitors.templates.create

EscrituraDesde 2026-11-01

Creates a draft monitor template in this organization for one platform (one of the platforms with a monitor tab; the CRM has none), with a title, an optional description and one empty page. Its widgets are designed in MB Suite's monitor editor; publish it with monitors.templates.publish so it can be assigned (monitors.assignments.set) and, for a workspace, used by its accounts. To start from a system monitor use monitors.templates.clone instead. Returns the template id. Requires edit access to Monitors.

Alcance: monitors:write
Permiso: Editar en el módulo
Tool del MCP: monitors_templates_createEn la superficie completa; en la compacta, mb_execute_operation con id: "monitors.templates.create".

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

Parámetros

titlestringcuerporequerido

The template title (up to 200 characters).

platformenumcuerporequerido

The platform it is built for: the tab it can be assigned to (it cannot change later).

descriptionstringcuerpoopcional

A description (up to 2000 characters).

Respuesta

template_idstring

Errores

invalid_input unknown_field authentication_required scope_insufficient crm_action_denied idempotency_key_reused rate_limited quota_exceeded

Ejemplo

curl -X POST "https://api.mb-suite.com/v1/monitors/templates" \
  -H "Authorization: Bearer $MB_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
  "title": "TITLE",
  "platform": "google_analytics"
}'

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/templates" \
  -H "Authorization: Bearer $MB_TEST_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
  "title": "TITLE",
  "platform": "google_analytics"
}'

PATCH/v1/monitors/templates/{template_id}

Update a monitor template's details

monitors.templates.update

EscrituraIdempotenteDesde 2026-11-01

Updates the title, description, subtitle, labels or cover gradient of one of the organization's own monitor templates (the fields go at the top level of the input, next to template_id). label_ids replaces the template's labels and must be ids from monitors.labels.list (label_unknown otherwise). Widgets are designed in MB Suite's monitor editor; the publication status changes with monitors.templates.publish; the platform cannot change. Tabs that show this monitor (here and, for a published workspace template, in its accounts) show the new details. Returns the updated template. Requires edit access to Monitors.

Alcance: monitors:write
Permiso: Editar en el módulo
Tool del MCP: monitors_templates_updateEn la superficie completa; en la compacta, mb_execute_operation con id: "monitors.templates.update".

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

Parámetros

template_idstringrutarequerido

The monitor template id (monitors.templates.list).

titlestringcuerpoopcional

New title (up to 200 characters).

descriptionstringcuerpoopcional

New description (up to 2000 characters).

subtitlestringcuerpoopcional

New subtitle (up to 500 characters).

label_idsarray<string>cuerpoopcional

Replaces the template's labels: ids from monitors.labels.list (label_unknown otherwise; up to 50).

styleobjectcuerpoopcional

The cover style.

Respuesta

templateobject

Errores

monitor_template_not_found invalid_input unknown_field authentication_required scope_insufficient crm_action_denied idempotency_key_reused rate_limited quota_exceeded

Ejemplo

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

POST/v1/monitors/templates/{template_id}/publish

Publish a monitor template or move it back to draft

monitors.templates.publish

EscrituraIdempotenteDesde 2026-11-01

Sets the publication status of one of the organization's own monitor templates: published (it can be assigned to its platform's tab, and a workspace's published templates are offered to its accounts as INHERITED) or draft (status: draft; tabs that already show it fall back to the monitor picker until it is published again). Idempotent: changed is false when it already had that status. Requires edit access to Monitors.

Alcance: monitors:write
Permiso: Editar en el módulo
Tool del MCP: monitors_templates_publishEn la superficie completa; en la compacta, mb_execute_operation con id: "monitors.templates.publish".
Eventos que puede emitir: monitors.template.published

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

Parámetros

template_idstringrutarequerido

The monitor template id (monitors.templates.list).

statusenumcuerpoopcional

published (default: it can be assigned and, for a workspace, its accounts see it) or draft.

Valores: published, draft · Por defecto: "published"

Respuesta

template_idstring

statusenum

Valores: draft, published

changedboolean

Errores

monitor_template_not_found invalid_input unknown_field authentication_required scope_insufficient crm_action_denied idempotency_key_reused rate_limited quota_exceeded

Ejemplo

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

POST/v1/monitors/templates/{template_id}/duplicate

Duplicate a monitor template

monitors.templates.duplicate

EscrituraDesde 2026-11-01

Copies one of the organization's own monitor templates (page, widgets, filters, style, platform) into a new draft titled '<title> (Copia)' (the suffix in the caller's language: (Copia), (Copy) or (Cópia)). Returns the new template id. Requires edit access to Monitors.

Alcance: monitors:write
Permiso: Editar en el módulo
Tool del MCP: monitors_templates_duplicateEn la superficie completa; en la compacta, mb_execute_operation con id: "monitors.templates.duplicate".

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

Parámetros

template_idstringrutarequerido

The monitor template id (monitors.templates.list).

Respuesta

template_idstring

Errores

monitor_template_not_found invalid_input unknown_field authentication_required scope_insufficient crm_action_denied idempotency_key_reused rate_limited quota_exceeded

Ejemplo

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

POST/v1/monitors/templates/clone

Copy a system monitor into the organization

monitors.templates.clone

EscrituraDesde 2026-11-01

Copies a published system monitor (source SYSTEM in monitors.templates.list) into the organization's own templates as a draft, so it can be customized and published; title names the copy (default the system monitor's title with the copy suffix in the caller's language, e.g. '<title> (Copia)'), and it goes after the organization's own templates. To just use a system monitor as it is, assign it directly with monitors.assignments.set (source SYSTEM). Returns the new template id. Not found (system_monitor_not_found) if there is no published system monitor with that id. Requires edit access to Monitors.

Alcance: monitors:write
Permiso: Editar en el módulo
Tool del MCP: monitors_templates_cloneEn la superficie completa; en la compacta, mb_execute_operation con id: "monitors.templates.clone".

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

Parámetros

system_template_idstringcuerporequerido

The published system monitor to copy (source SYSTEM in monitors.templates.list).

titlestringcuerpoopcional

The copy's title. Without it, the system monitor's title with the copy suffix in the caller's language: (Copia), (Copy) or (Cópia).

Respuesta

template_idstring

Errores

system_monitor_not_found invalid_input unknown_field authentication_required scope_insufficient crm_action_denied idempotency_key_reused rate_limited quota_exceeded

Ejemplo

curl -X POST "https://api.mb-suite.com/v1/monitors/templates/clone" \
  -H "Authorization: Bearer $MB_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
  "system_template_id": "SYSTEM_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/templates/clone" \
  -H "Authorization: Bearer $MB_TEST_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
  "system_template_id": "SYSTEM_TEMPLATE_ID"
}'

DELETE/v1/monitors/templates/{template_id}

Delete a monitor template

monitors.templates.delete

IrreversibleDesde 2026-11-01

Deletes one of the organization's own monitor templates. It goes to the 30-day trash. Platform tabs that show it (in this organization and, if a workspace published it, in its accounts) keep their assignment but show the monitor picker until it is restored; restoring it brings them back as they were. The dry run says how many of this organization's tabs use it. Outside the screen it requires a dry run and a confirm_token, except a plain REST DELETE with a key allowed to delete. Requires edit access to Monitors.

Instrucciones para agentes

Before confirming, tell the person how many platform tabs show this monitor (the dry run says it) and that restoring it from the trash brings them back.

Con una API key, este DELETE se ejecuta directo: el registro queda 30 días en la papelera y la respuesta trae su trash_item_id. Con un token OAuth, y por el MCP, pide dry_run → confirm_token.

Alcance: monitors:write y «Permitir eliminar» (monitors:delete en OAuth)
Permiso: Editar en el módulo
Tool del MCP: monitors_templates_deleteEn la superficie completa; en la compacta, mb_execute_operation con id: "monitors.templates.delete".

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

Parámetros

template_idstringrutarequerido

The monitor template id (monitors.templates.list).

Respuesta

oktrue

trash_item_idstring

The trash item this deletion left: the item_id of platform.trash.restore (POST /trash/{item_id}/restore). Missing if nothing went to the trash.

trash_item_idsarray<string>

Only when the deletion left more than one copy: all of them, the first being trash_item_id.

trash_expires_atnumber

When the copy leaves the trash for good (epoch ms): 30 days after the deletion.

Errores

monitor_template_not_found delete_not_allowed confirmation_required invalid_input unknown_field authentication_required scope_insufficient crm_action_denied idempotency_key_reused rate_limited quota_exceeded

Ejemplo

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