Visualizações do Explorer

List saved explorer views

dashboards.explorer_views.list

Lists the organization's saved Explorer views (module analytics) and CRM reports (module crm, only if the caller can see the CRM), in their manual order, paginated by cursor. Each view has its name, layout (stack or grid), date range and its tables, KPIs and charts with platform, metrics and dimensions. Filter with module. It does not return data: the numbers are read live in MB Suite.

Escopo

dashboards:read

Permissão

Ver o módulo

Tool do MCP

dashboards_explorer_views_listNa superfície completa; na compacta, mb_execute_operation com id: "dashboards.explorer_views.list".

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

Parâmetros

Resposta

Erros

Exemplo

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

Get one explorer view

dashboards.explorer_views.get

Returns a saved Explorer view or CRM report with its name, module, layout, date range and its tables, KPIs and charts. A CRM report requires access to the CRM. Not found if the id does not exist in this organization.

Escopo

dashboards:read

Permissão

Ver o módulo

Tool do MCP

dashboards_explorer_views_getNa superfície completa; na compacta, mb_execute_operation com id: "dashboards.explorer_views.get".

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

Parâmetros

Resposta

Erros

Exemplo

curl "https://api.mb-suite.com/v1/dashboards/explorer-views/{view_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/dashboards/explorer-views/{view_id}" \
  -H "Authorization: Bearer $MB_TEST_KEY"

Save a new explorer view

dashboards.explorer_views.create

Saves a new Explorer view with a name, date range (default last 30 days), layout and its tables. With module crm it is a CRM report (shown in CRM → Performance → Reports) and requires edit access to the CRM as well. Each item of tables is a table, KPI or chart: type single (one platform or data source) or multi (several platforms), item_type table|kpi|graph, platform, data_source_id, platforms, dimensions (ids, or {id, level} to nest), metrics (metric ids of the platform, or custom:<id> of dashboards.custom_metrics.list), filters ({id, field_id, operator, value}), sorts, column_widths and custom_labels (keyed by metric or dimension id), and for a grid layout x, y, w, h. New platforms, metrics, dimensions and filter operators are checked against the platform's registry (unknown_platform, unknown_metric, unknown_dimension, invalid_table_filter, with the valid ones in details); ids the view already had are kept. A new preset_key must be one of the presets (preset_unknown). Returns the new view id. Requires edit access to Dashboards.

Escopo

dashboards:write

Permissão

Editar no módulo

Tool do MCP

dashboards_explorer_views_createNa superfície completa; na compacta, mb_execute_operation com id: "dashboards.explorer_views.create".

Custo declarado: até 2 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/dashboards/explorer-views" \
  -H "Authorization: Bearer $MB_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
  "name": "NAME"
}'

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

Update an explorer view

dashboards.explorer_views.update

Updates the name, date range, layout and/or the full list of tables of a saved Explorer view or CRM report (the module does not change; a CRM report requires edit access to the CRM as well). Each item of tables is a table, KPI or chart: type single (one platform or data source) or multi (several platforms), item_type table|kpi|graph, platform, data_source_id, platforms, dimensions (ids, or {id, level} to nest), metrics (metric ids of the platform, or custom:<id> of dashboards.custom_metrics.list), filters ({id, field_id, operator, value}), sorts, column_widths and custom_labels (keyed by metric or dimension id), and for a grid layout x, y, w, h. New platforms, metrics, dimensions and filter operators are checked against the platform's registry (unknown_platform, unknown_metric, unknown_dimension, invalid_table_filter, with the valid ones in details); ids the view already had are kept. A new preset_key must be one of the presets (preset_unknown). Returns the updated view. Requires edit access to Dashboards.

Escopo

dashboards:write

Permissão

Editar no módulo

Tool do MCP

dashboards_explorer_views_updateNa superfície completa; na compacta, mb_execute_operation com id: "dashboards.explorer_views.update".

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

Parâmetros

Resposta

Erros

Exemplo

curl -X PATCH "https://api.mb-suite.com/v1/dashboards/explorer-views/{view_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 -X PATCH "https://api.mb-suite.com/v1/dashboards/explorer-views/{view_id}" \
  -H "Authorization: Bearer $MB_TEST_KEY"

Duplicate an explorer view

dashboards.explorer_views.duplicate

Copies a saved Explorer view or CRM report into a new one titled '<name> (Copia)' (the suffix in the caller's language: (Copia), (Copy) or (Cópia)) with the same module, layout, date range and tables. Returns the new view id. Requires edit access to Dashboards (and to the CRM for a CRM report).

Escopo

dashboards:write

Permissão

Editar no módulo

Tool do MCP

dashboards_explorer_views_duplicateNa superfície completa; na compacta, mb_execute_operation com id: "dashboards.explorer_views.duplicate".

Custo declarado: até 3 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/dashboards/explorer-views/{view_id}/duplicate" \
  -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/dashboards/explorer-views/{view_id}/duplicate" \
  -H "Authorization: Bearer $MB_TEST_KEY"

Reorder explorer views

dashboards.explorer_views.reorder

Sets the manual order of the Explorer views (or of the CRM reports): pass the ids of ONE list, Explorer views or CRM reports, in the new order; mixing both lists is mixed_view_lists. Every id must exist. Requires edit access to Dashboards (and to the CRM when CRM reports are included).

Escopo

dashboards:write

Permissão

Editar no módulo

Tool do MCP

dashboards_explorer_views_reorderNa superfície completa; na compacta, mb_execute_operation com id: "dashboards.explorer_views.reorder".

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

Parâmetros

Resposta

Erros

Exemplo

curl -X POST "https://api.mb-suite.com/v1/dashboards/explorer-views/reorder" \
  -H "Authorization: Bearer $MB_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
  "view_ids": [
    "VIEW_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/dashboards/explorer-views/reorder" \
  -H "Authorization: Bearer $MB_TEST_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
  "view_ids": [
    "VIEW_ID"
  ]
}'

Delete an explorer view

dashboards.explorer_views.delete

Deletes a saved Explorer view or CRM report. It goes to the 30-day trash. Accounts that inherited it stop seeing it until it is restored: the dry run names the view and says how many of the workspace's accounts inherit 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 Dashboards (and to the CRM for a CRM report).

Com uma API key, este DELETE roda direto: o registro fica 30 dias na lixeira e a resposta traz o seu trash_item_id. Com um token OAuth, e pelo MCP, pede dry_run → confirm_token.

Escopo

dashboards:write e «Permitir exclusões» (dashboards:delete no OAuth)

Permissão

Editar no módulo

Tool do MCP

dashboards_explorer_views_deleteNa superfície completa; na compacta, mb_execute_operation com id: "dashboards.explorer_views.delete".

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

Parâmetros

Resposta

Erros

Exemplo

curl -X DELETE "https://api.mb-suite.com/v1/dashboards/explorer-views/{view_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 -X DELETE "https://api.mb-suite.com/v1/dashboards/explorer-views/{view_id}" \
  -H "Authorization: Bearer $MB_TEST_KEY"