Menu

Referência da API · Reports

Etiquetas

reports · labels · 1 operação

GET/v1/reports/labels

List the labels of report templates or reports

reports.labels.list

LeituraIdempotenteDesde 2026-11-01

Lists the labels this organization uses to organize its report templates (of: templates, the default) or its editable reports and report instances (of: reports): id, name, color and order, in the screen's order (up to 200). Use the ids in label_ids of reports.templates.create/update, reports.reports.create/update or reports.instances.update; an id that is not here is label_unknown. Labels are created and edited in MB Suite. Requires view access to Reports.

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

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

Parâmetros

ofenumqueryopcional

templates (report templates, default) or reports (editable reports and report instances).

Valores: templates, reports · Padrão: "templates"

Resposta

dataarray<object>

The labels, in the screen's order.

Erros

Exemplo

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