Menú

Referencia de la API · Reports

Plantillas de página

reports · section_templates · 4 operaciones

GET/v1/reports/section-templatesList saved report pages GET/v1/reports/section-templates/{section_template_id}Get a saved report page POST/v1/reports/section-templatesSave a report page for reuse DELETE/v1/reports/section-templates/{section_template_id}Delete a saved report page

GET/v1/reports/section-templates

List saved report pages

reports.section_templates.list

LecturaIdempotenteDesde 2026-11-01

Lists the report pages saved by the organization to reuse in other templates (section templates), newest first, paginated by cursor: name, description, page title and how many blocks it has. Fetch the blocks with reports.section_templates.get. Requires view access to Reports.

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

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

Parámetros

limitintegerqueryopcional

How many section 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_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/reports/section-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/section-templates" \
  -H "Authorization: Bearer $MB_TEST_KEY"

GET/v1/reports/section-templates/{section_template_id}

Get a saved report page

reports.section_templates.get

LecturaIdempotenteDesde 2026-11-01

Returns one saved report page (section template) with its title and all its blocks, ready to add to a template's sections. Not found if it does not exist in the organization. Requires view access to Reports.

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

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

Parámetros

section_template_idstringrutarequerido

The section template id (reports.section_templates.list).

Respuesta

idstring

Section template id.

namestring

Name.

sectionobject

The saved page with its blocks.

descriptionstring | null

Description.

created_atnumber | null

Created (epoch ms).

updated_atnumber | null

Last edited (epoch ms).

created_bystring | null

Uid of who saved it.

Errores

report_section_template_not_found 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/reports/section-templates/{section_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/section-templates/{section_template_id}" \
  -H "Authorization: Bearer $MB_TEST_KEY"

POST/v1/reports/section-templates

Save a report page for reuse

reports.section_templates.create

EscrituraDesde 2026-11-01

Saves a report page (a section with its blocks, as it is in a template or a report) with a name and an optional description, so it can be added to other templates. Blocks that read a platform must point to a slot or to a data source connected to the organization. Returns its id. Requires edit access to Reports.

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

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

Parámetros

namestringcuerporequerido

Name of the saved page.

sectionobjectcuerporequerido

The page as it is in a template or report (title, position and blocks; new block types, metrics and presets are checked).

descriptionstringcuerpoopcional

Description.

Respuesta

section_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/reports/section-templates" \
  -H "Authorization: Bearer $MB_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
  "name": "NAME",
  "section": {}
}'

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

DELETE/v1/reports/section-templates/{section_template_id}

Delete a saved report page

reports.section_templates.delete

IrreversibleDesde 2026-11-01

Deletes a saved report page; it stays 30 days in the trash. Templates that already used it keep their copy of the page. Requires edit access to Reports. Outside the screen it needs a dry run and a confirm_token, or a key with deletion enabled.

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: reports:write y «Permitir eliminar» (reports:delete en OAuth)
Permiso: Editar en el módulo
Tool del MCP: reports_section_templates_deleteEn la superficie completa; en la compacta, mb_execute_operation con id: "reports.section_templates.delete".

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

Parámetros

section_template_idstringrutarequerido

The section template id (reports.section_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

report_section_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/reports/section-templates/{section_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/reports/section-templates/{section_template_id}" \
  -H "Authorization: Bearer $MB_TEST_KEY"