List the labels of report templates or reports
reports.labels.list
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.
- Scope
reports:read- Permission
- View the module
- MCP tool
reports_labels_listOn the full surface; on the compact one,mb_execute_operationwithid: "reports.labels.list".
Declared cost: up to 200 reads and 0 writes per call (they count against the daily quota).
Parameters
ofenumqueryoptionaltemplates (report templates, default) or reports (editable reports and report instances).
Values: templates, reports · Default: "templates"
Response
dataarray<object>The labels, in the screen's order.
Errors
Example
curl "https://api.mb-suite.com/v1/reports/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/reports/labels" \
-H "Authorization: Bearer $MB_TEST_KEY"