Referência da API · Dashboards

Visualizações cross-account do Explorer

dashboards · cross_account_explorer_views · 7 operações

GET/v1/dashboards/cross-account-explorer-viewsList cross-account explorer views GET/v1/dashboards/cross-account-explorer-views/{view_id}Get one cross-account explorer view POST/v1/dashboards/cross-account-explorer-viewsSave a new cross-account explorer view PATCH/v1/dashboards/cross-account-explorer-views/{view_id}Update a cross-account explorer view POST/v1/dashboards/cross-account-explorer-views/{view_id}/duplicateDuplicate a cross-account explorer view POST/v1/dashboards/cross-account-explorer-views/reorderReorder cross-account explorer views DELETE/v1/dashboards/cross-account-explorer-views/{view_id}Delete a cross-account explorer view

GET/v1/dashboards/cross-account-explorer-views

List cross-account explorer views

dashboards.cross_account_explorer_views.list

LeituraIdempotenteDesde 2026-11-01

Lists the workspace's saved cross-account Explorer views (tables whose rows break down every account of the workspace), in their manual order, paginated by cursor. An account (child organization) has none: the list comes back empty. It does not return data.

Escopo: dashboards:read
Permissão: Ver o módulo
Tool do MCP: dashboards_cross_account_explorer_views_listNa superfície completa; na compacta, mb_execute_operation com id: "dashboards.cross_account_explorer_views.list".

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

Parâmetros

limitintegerqueryopcional

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

Padrão: 50

cursorstringqueryopcional

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

Resposta

dataarray<object>

has_moreboolean

next_cursorstring

Erros

invalid_input unknown_field authentication_required scope_insufficient module_access_denied operation_not_found rate_limited quota_exceeded

Exemplo

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

GET/v1/dashboards/cross-account-explorer-views/{view_id}

Get one cross-account explorer view

dashboards.cross_account_explorer_views.get

LeituraIdempotenteDesde 2026-11-01

Returns a saved cross-account Explorer view of the workspace with its name, date range and tables (single-platform tables; rows are broken down by account). Not found if the id does not exist in this workspace.

Escopo: dashboards:read
Permissão: Ver o módulo
Tool do MCP: dashboards_cross_account_explorer_views_getNa superfície completa; na compacta, mb_execute_operation com id: "dashboards.cross_account_explorer_views.get".

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

Parâmetros

view_idstringrotaobrigatório

The view id (its list operation).

Resposta

idstring

View id.

namestring

Name.

moduleenum

analytics (Explorer) or crm (a CRM report).

Valores: analytics, crm

layoutenum

stack or grid.

Valores: stack, grid

date_rangeobject | null

The view's period.

tablesarray<object>

Its tables, KPIs and charts.

ordernumber | null

Manual order in its list.

is_favoriteboolean

Marked as favorite.

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

Erros

cross_account_explorer_view_not_found invalid_input unknown_field authentication_required scope_insufficient module_access_denied operation_not_found rate_limited quota_exceeded

Exemplo

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

POST/v1/dashboards/cross-account-explorer-views

Save a new cross-account explorer view

dashboards.cross_account_explorer_views.create

EscritaDesde 2026-11-01

Saves a new cross-account Explorer view in the workspace with a name, date range (default last 30 days) and its tables (single-platform: type single with platform, dimensions, metrics, filters, sorts, column_widths, custom_labels, density, heatmap_mode; a multi table is cross_account_table_single_platform). Platforms, metrics, dimensions, filter operators and the preset are checked as in dashboards.explorer_views.create. Only a workspace (agency) organization can have them. Returns the new view id. Requires edit access to Dashboards.

Escopo: dashboards:write
Permissão: Editar no módulo
Tool do MCP: dashboards_cross_account_explorer_views_createNa superfície completa; na compacta, mb_execute_operation com id: "dashboards.cross_account_explorer_views.create".

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

Parâmetros

namestringcorpoobrigatório

View name.

date_rangeobjectcorpoopcional

The view's period; default the last 30 days (type preset, preset_key last_30_days).

tablesarray<object>corpoopcional

The tables of the view: each one single-platform (type single with its platform).

Resposta

view_idstring

The new view's id.

Erros

invalid_input unknown_field authentication_required scope_insufficient crm_action_denied idempotency_key_reused rate_limited quota_exceeded

Exemplo

curl -X POST "https://api.mb-suite.com/v1/dashboards/cross-account-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/cross-account-explorer-views" \
  -H "Authorization: Bearer $MB_TEST_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
  "name": "NAME"
}'

PATCH/v1/dashboards/cross-account-explorer-views/{view_id}

Update a cross-account explorer view

dashboards.cross_account_explorer_views.update

EscritaIdempotenteDesde 2026-11-01

Updates the name, date range and/or the full list of tables of a cross-account Explorer view of the workspace. Returns the updated view. Requires edit access to Dashboards.

Escopo: dashboards:write
Permissão: Editar no módulo
Tool do MCP: dashboards_cross_account_explorer_views_updateNa superfície completa; na compacta, mb_execute_operation com id: "dashboards.cross_account_explorer_views.update".

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

Parâmetros

view_idstringrotaobrigatório

The view id (its list operation).

namestringcorpoopcional

New name.

date_rangeobjectcorpoopcional

New period.

tablesarray<object>corpoopcional

All the tables (replaces the list); each one single-platform.

Resposta

viewobject

The view as saved.

Erros

cross_account_explorer_view_not_found invalid_input unknown_field authentication_required scope_insufficient crm_action_denied idempotency_key_reused rate_limited quota_exceeded

Exemplo

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

POST/v1/dashboards/cross-account-explorer-views/{view_id}/duplicate

Duplicate a cross-account explorer view

dashboards.cross_account_explorer_views.duplicate

EscritaDesde 2026-11-01

Copies a cross-account Explorer view into a new one titled '<name> (Copia)' with the same date range and tables. Returns the new view id. Requires edit access to Dashboards.

Escopo: dashboards:write
Permissão: Editar no módulo
Tool do MCP: dashboards_cross_account_explorer_views_duplicateNa superfície completa; na compacta, mb_execute_operation com id: "dashboards.cross_account_explorer_views.duplicate".

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

Parâmetros

view_idstringrotaobrigatório

The view id (its list operation).

Resposta

view_idstring

The new view's id.

Erros

cross_account_explorer_view_not_found invalid_input unknown_field authentication_required scope_insufficient crm_action_denied idempotency_key_reused rate_limited quota_exceeded

Exemplo

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

POST/v1/dashboards/cross-account-explorer-views/reorder

Reorder cross-account explorer views

dashboards.cross_account_explorer_views.reorder

EscritaIdempotenteDesde 2026-11-01

Sets the manual order of the workspace's cross-account Explorer views: pass their ids in the new order; every id must exist. Requires edit access to Dashboards in the workspace.

Escopo: dashboards:write
Permissão: Editar no módulo
Tool do MCP: dashboards_cross_account_explorer_views_reorderNa superfície completa; na compacta, mb_execute_operation com id: "dashboards.cross_account_explorer_views.reorder".

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

Parâmetros

view_idsarray<string>corpoobrigatório

The ids of ONE list (Explorer views or CRM reports, not both) in the new order.

Resposta

countnumber

How many views were ordered.

changednumber

How many of them moved (only those are written), like dashboards.dashboards.reorder.

Erros

invalid_input unknown_field authentication_required scope_insufficient crm_action_denied idempotency_key_reused rate_limited quota_exceeded

Exemplo

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

DELETE/v1/dashboards/cross-account-explorer-views/{view_id}

Delete a cross-account explorer view

dashboards.cross_account_explorer_views.delete

IrreversívelDesde 2026-11-01

Deletes a cross-account Explorer view of the workspace. It goes to the 30-day trash. 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.

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_cross_account_explorer_views_deleteNa superfície completa; na compacta, mb_execute_operation com id: "dashboards.cross_account_explorer_views.delete".

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

Parâmetros

view_idstringrotaobrigatório

The view id (its list operation).

Resposta

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.

Erros

cross_account_explorer_view_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

Exemplo

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