Cross-account

List cross-account dashboards

dashboards.cross_account.list

Lists the workspace's cross-account dashboards (dashboards whose widgets read every account of the workspace, or several sub-accounts of one workspace credential when is_multi_account), most recently updated first, paginated by cursor. An account (child organization) has none: the list comes back empty. Use dashboards.cross_account.get for the pages and widgets.

Scope

dashboards:read

Permission

View the module

MCP tool

dashboards_cross_account_listOn the full surface; on the compact one, mb_execute_operation with id: "dashboards.cross_account.list".

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

Parameters

Response

Errors

Example

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

Get one cross-account dashboard

dashboards.cross_account.get

Returns a cross-account dashboard of the workspace with its date range, filters and its pages with a summary of each widget (type, title, platform, metrics, dimensions, grid position). It does not return widget data. Not found if the id does not exist in this workspace.

Scope

dashboards:read

Permission

View the module

MCP tool

dashboards_cross_account_getOn the full surface; on the compact one, mb_execute_operation with id: "dashboards.cross_account.get".

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

Parameters

Response

Errors

Example

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

Create a cross-account dashboard

dashboards.cross_account.create

Creates an empty cross-account dashboard in the workspace (one blank page) with a title, optional description and is_multi_account (widgets that add up several sub-accounts of one workspace credential). Its widgets are designed in MB Suite. Only a workspace (agency) organization can have them: an account gets workspace_only. Returns the new id. Requires edit access to Dashboards.

Scope

dashboards:write

Permission

Edit in the module

MCP tool

dashboards_cross_account_createOn the full surface; on the compact one, mb_execute_operation with id: "dashboards.cross_account.create".

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

Parameters

Response

Errors

Example

curl -X POST "https://api.mb-suite.com/v1/dashboards/cross-account" \
  -H "Authorization: Bearer $MB_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
  "title": "TITLE"
}'

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/cross-account" \
  -H "Authorization: Bearer $MB_TEST_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
  "title": "TITLE"
}'

Update a cross-account dashboard

dashboards.cross_account.update

Updates the title, description and/or labels (ids from dashboards.labels.list with of: cross_account; an unknown one is label_unknown) of a cross-account dashboard. Pages, widgets, date range and filters are edited in MB Suite. Returns the updated dashboard. Requires edit access to Dashboards.

Scope

dashboards:write

Permission

Edit in the module

MCP tool

dashboards_cross_account_updateOn the full surface; on the compact one, mb_execute_operation with id: "dashboards.cross_account.update".

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

Parameters

Response

Errors

Example

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

Duplicate a cross-account dashboard

dashboards.cross_account.duplicate

Copies a cross-account dashboard (pages, widgets, date range, filters) into a new one titled '<title> (Copia)' (the suffix in the caller's language: (Copia), (Copy) or (Cópia)), not featured. Returns the new id. Requires edit access to Dashboards.

Scope

dashboards:write

Permission

Edit in the module

MCP tool

dashboards_cross_account_duplicateOn the full surface; on the compact one, mb_execute_operation with id: "dashboards.cross_account.duplicate".

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

Parameters

Response

Errors

Example

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

Delete a cross-account dashboard

dashboards.cross_account.delete

Deletes a cross-account dashboard 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.

With an API key, this DELETE runs directly: the record stays 30 days in the trash and the response carries its trash_item_id. With an OAuth token, and through the MCP, it needs dry_run → confirm_token.

Scope

dashboards:write and “Allow deletions” (dashboards:delete in OAuth)

Permission

Edit in the module

MCP tool

dashboards_cross_account_deleteOn the full surface; on the compact one, mb_execute_operation with id: "dashboards.cross_account.delete".

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

Parameters

Response

Errors

Example

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