Menu

API reference · Dashboards

Labels

dashboards · labels · 1 operation

GET/v1/dashboards/labels

List the labels of dashboards, templates or cross-account dashboards

dashboards.labels.list

ReadIdempotentSince 2026-11-01

Lists the labels this organization uses to organize its dashboards (of: dashboards), its dashboard templates (of: templates) or its cross-account dashboards (of: cross_account): id, name, color and order, in the screen's order (up to 200). Use the ids in label_ids of dashboards.dashboards.update, dashboards.templates.update or dashboards.cross_account.update; an id that is not here is label_unknown. Labels are created and edited in MB Suite. Requires view access to Dashboards.

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

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

Parameters

ofenumqueryoptional

Whose labels: dashboards (label_ids of dashboards.dashboards.update), templates (dashboards.templates.update) or cross_account (dashboards.cross_account.update). Default dashboards.

Values: dashboards, templates, cross_account · Default: "dashboards"

Response

dataarray<object>

The labels, in the screen's order.

Errors

Example

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