Menu

API reference · Dashboards

Inherited Explorer views

dashboards · inherited_explorer_views · 4 operations

GET/v1/dashboards/inherited-explorer-views

List the explorer views an account inherited

dashboards.inherited_explorer_views.list

ReadIdempotentSince 2026-11-01

Lists the Explorer views this account took from its workspace, each with its reference id (ref_id, used to remove it), the workspace view and whether it is still available (false if the workspace deleted it). A workspace has none. It does not return data.

Scope
dashboards:read
Permission
View the module
MCP tool
dashboards_inherited_explorer_views_listOn the full surface; on the compact one, mb_execute_operation with id: "dashboards.inherited_explorer_views.list".

Declared cost: up to 402 reads and 0 writes per call (they count against the daily quota).

Parameters

No parameters.

Response

dataarray<object>

The inherited views (up to 200).

Errors

Example

curl "https://api.mb-suite.com/v1/dashboards/inherited-explorer-views" \
  -H "Authorization: Bearer $MB_API_KEY"

Try it with your test API key

With a test API key the request always goes to your practice organization: example data you can reset.

curl "https://api.mb-suite.com/v1/dashboards/inherited-explorer-views" \
  -H "Authorization: Bearer $MB_TEST_KEY"
GET/v1/dashboards/inherited-explorer-views/available

List the workspace views an account can inherit

dashboards.inherited_explorer_views.available

ReadIdempotentSince 2026-11-01

Lists the Explorer views of this account's workspace that it can inherit (the workspace's CRM reports are not inheritable), most recently updated first, paginated by cursor. Use their ids with dashboards.inherited_explorer_views.add. Only for an account: a workspace gets not_an_account.

Scope
dashboards:read
Permission
View the module
MCP tool
dashboards_inherited_explorer_views_availableOn the full surface; on the compact one, mb_execute_operation with id: "dashboards.inherited_explorer_views.available".

Declared cost: up to 501 reads and 0 writes per call (they count against the daily quota).

Parameters

limitintegerqueryoptional

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

Default: 50

cursorstringqueryoptional

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

Response

dataarray<object>
has_moreboolean
next_cursorstring

Errors

Example

curl "https://api.mb-suite.com/v1/dashboards/inherited-explorer-views/available" \
  -H "Authorization: Bearer $MB_API_KEY"

Try it with your test API key

With a test API key the request always goes to your practice organization: example data you can reset.

curl "https://api.mb-suite.com/v1/dashboards/inherited-explorer-views/available" \
  -H "Authorization: Bearer $MB_TEST_KEY"
POST/v1/dashboards/inherited-explorer-views

Inherit explorer views from the workspace

dashboards.inherited_explorer_views.add

WriteIdempotentSince 2026-11-01

Adds up to 50 Explorer views of this account's workspace (ids from dashboards.inherited_explorer_views.available) to the account's Explorer, as live references: they follow the workspace's edits and read the account's own data. Views already inherited are skipped and come back in already_inherited with their reference id, so repeating is safe. Every view must exist in the workspace; CRM reports cannot be inherited. Returns how many were added and their reference ids. Requires edit access to Dashboards in the account.

Scope
dashboards:write
Permission
Edit in the module
MCP tool
dashboards_inherited_explorer_views_addOn the full surface; on the compact one, mb_execute_operation with id: "dashboards.inherited_explorer_views.add".

Declared cost: up to 251 reads and 50 writes per call (they count against the daily quota).

Parameters

parent_view_idsarray<string>bodyrequired

Views of the workspace (dashboards.inherited_explorer_views.available).

parent_org_idstringbodyoptional

This account's workspace (optional: it must be its own).

Response

addednumber

How many views were inherited now.

ref_idsarray<string>

Reference ids of the ones added now.

already_inheritedarray<object>

Requested views the account already had.

Errors

Example

curl -X POST "https://api.mb-suite.com/v1/dashboards/inherited-explorer-views" \
  -H "Authorization: Bearer $MB_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
  "parent_view_ids": [
    "PARENT_VIEW_ID"
  ]
}'

Try it with your test API key

With a test API key the request always goes to your practice organization: example data you can reset.

curl -X POST "https://api.mb-suite.com/v1/dashboards/inherited-explorer-views" \
  -H "Authorization: Bearer $MB_TEST_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
  "parent_view_ids": [
    "PARENT_VIEW_ID"
  ]
}'
POST/v1/dashboards/inherited-explorer-views/{ref_id}/remove

Stop inheriting an explorer view

dashboards.inherited_explorer_views.remove

WriteIdempotentSince 2026-11-01

Removes an inherited view (by its ref_id from dashboards.inherited_explorer_views.list) from the account's Explorer. Only the reference goes: the workspace's view is not touched and can be inherited again. Idempotent: a reference that is no longer there returns removed: false. Requires edit access to Dashboards in the account.

Scope
dashboards:write
Permission
Edit in the module
MCP tool
dashboards_inherited_explorer_views_removeOn the full surface; on the compact one, mb_execute_operation with id: "dashboards.inherited_explorer_views.remove".

Declared cost: up to 1 reads and 1 writes per call (they count against the daily quota).

Parameters

ref_idstringpathrequired

The reference id (ref_id of dashboards.inherited_explorer_views.list).

Response

oktrue

Always true.

removedboolean

false when the reference was already gone.

Errors

Example

curl -X POST "https://api.mb-suite.com/v1/dashboards/inherited-explorer-views/{ref_id}/remove" \
  -H "Authorization: Bearer $MB_API_KEY"

Try it with your test API key

With a test API key the request always goes to your practice organization: example data you can reset.

curl -X POST "https://api.mb-suite.com/v1/dashboards/inherited-explorer-views/{ref_id}/remove" \
  -H "Authorization: Bearer $MB_TEST_KEY"