MB SuiteMB Suite
Menú

Referencia de la API · Reports

Plantillas del sistema

reports · system_templates · 3 operaciones

GET/v1/reports/system-templatesGET/v1/reports/system-templates/{template_id}POST/v1/reports/system-templates/{template_id}/clone
GET/v1/reports/system-templates

List MB Suite's published system report templates

reports.system_templates.list

LecturaIdempotenteDesde 2026-11-01

Lists the published system report templates (the MB Suite catalog: one per platform and goal, e.g. «Google Ads — Leads») in gallery order, as summaries with their data source slots and supported platforms. Use one with reports.instances.generate or reports.templates.deploy (template_source=SYSTEM), or copy it into the organization with reports.system_templates.clone. Draft system templates are skipped by reading further, so pages come full. Requires view access to Reports.

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

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

Parámetros

limitintegerqueryopcional

How many system templates per page (default 50, at most 200).

Por defecto: 50

cursorstringqueryopcional

The next_cursor of the previous page, to get the next one; omit it for the first page.

Respuesta

dataarray<object>
has_moreboolean
next_cursorstring

Errores

invalid_inputunknown_fieldauthentication_requiredscope_insufficientmodule_access_deniedoperation_not_foundrate_limitedquota_exceeded

Ejemplo

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

Get a published system report template

reports.system_templates.get

LecturaIdempotenteDesde 2026-11-01

Returns one published system report template with all its pages and blocks, its data source slots (what a data_source_mapping has to cover) and its default date range. Not found if the id does not exist or the template is not published. Requires view access to Reports.

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

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

Parámetros

template_idstringrutarequerido

The system template id (reports.system_templates.list).

Respuesta

idstring

Template id.

titlestring

Title.

statusenum

draft or published.

Valores: draft, published

sourceenum

organization, inherited or system.

Valores: organization, inherited, system

descriptionstring | null

Description.

subtitlestring | null

Subtitle.

accent_colorstring | null

Accent color.

versionnumber | null

Version (goes up with each update and publication).

positionnumber | null

Manual order.

is_system_templateboolean | null

A system template.

supported_platformsarray<string> | null

Platforms it is built for.

data_source_slotsarray<object> | null

Data slots a report maps to its sources.

default_date_rangeobject | null

Default period (type preset, fixed or dynamic).

sectionsarray<object> | null

Pages and blocks, as stored.

cover_pageobject | null

Cover page settings.

table_of_contentsboolean | null

Whether it has a table of contents.

module_pagesarray<object> | null

Module pages and where they go.

label_idsarray<string> | null

Template labels.

theme_idstring | null

Report theme.

theme_sourcestring | null

system or organization.

data_freshness_checked_atnumber | null

When the editor last refreshed live data (epoch ms).

created_atnumber | null

Created (epoch ms).

updated_atnumber | null

Last edited (epoch ms).

created_bystring | null

Uid of who created it.

created_by_namestring | null

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

Errores

invalid_inputunknown_fieldauthentication_requiredscope_insufficientmodule_access_deniedoperation_not_foundrate_limitedquota_exceeded

Ejemplo

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

Copy a system report template into the organization

reports.system_templates.clone

EscrituraDesde 2026-11-01

Copies a published system report template into the organization's own templates as a draft titled '<title> (Copia)' (the suffix in the caller's language), so it can be edited and published like any other. Returns the new template id. Requires edit access to Reports.

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

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

Parámetros

template_idstringrutarequerido

The published system template (reports.system_templates.list).

Respuesta

template_idstring
titlestring

Errores

invalid_inputunknown_fieldauthentication_requiredscope_insufficientcrm_action_deniedidempotency_key_reusedrate_limitedquota_exceeded

Ejemplo

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