Etiquetas · Dashboards · Referência da API

GET/v1/dashboards/labels

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

dashboards.labels.list

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

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

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

Parâmetros

ofenumqueryopcional

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

Valores: dashboards, templates, cross_account · Padrão: "dashboards"

Resposta

dataarray<object>

The labels, in the screen's order.

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/labels" \
  -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/labels" \
  -H "Authorization: Bearer $MB_TEST_KEY"