Themes

List report themes

reports.themes.list

Lists the report themes available to the organization: the four system themes (classic, elegant, playful, bold; first, unless include_system is false) and the organization's own, newest first, in one list paginated by cursor (the system themes count in limit). Each theme has seven hex colors and its fonts. Apply one to a template, report or instance with theme_id + theme_source. Requires view access to Reports.

Scope

reports:read

Permission

View the module

MCP tool

reports_themes_listOn the full surface; on the compact one, mb_execute_operation with id: "reports.themes.list".

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

Parameters

Response

Errors

Example

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

Get a report theme

reports.themes.get

Returns one report theme: a system one (classic, elegant, playful, bold) or the organization's, with its colors and fonts; without source it looks in both. Not found if the id does not exist. Requires view access to Reports.

Scope

reports:read

Permission

View the module

MCP tool

reports_themes_getOn the full surface; on the compact one, mb_execute_operation with id: "reports.themes.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/reports/themes/{theme_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/reports/themes/{theme_id}" \
  -H "Authorization: Bearer $MB_TEST_KEY"

Create a report theme

reports.themes.create

Creates a report theme of the organization: a name (up to 100 characters), seven colors as #rrggbb (primary, secondary, background, text, heading, border, accent) and the fonts (Inter, Merriweather, Roboto, Playfair Display or Montserrat; an optional separate heading font). Returns the theme id. Requires edit access to Reports.

Scope

reports:write

Permission

Edit in the module

MCP tool

reports_themes_createOn the full surface; on the compact one, mb_execute_operation with id: "reports.themes.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/reports/themes" \
  -H "Authorization: Bearer $MB_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
  "name": "NAME",
  "colors": {},
  "typography": {}
}'

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/reports/themes" \
  -H "Authorization: Bearer $MB_TEST_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
  "name": "NAME",
  "colors": {},
  "typography": {}
}'

Update a report theme

reports.themes.update

Updates the name, the colors (all seven) or the fonts of one of the organization's report themes; everything that uses it changes look. System themes cannot be edited (409 system_theme_read_only). Returns the updated theme. Fields go inside updates. Requires edit access to Reports.

Scope

reports:write

Permission

Edit in the module

MCP tool

reports_themes_updateOn the full surface; on the compact one, mb_execute_operation with id: "reports.themes.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/reports/themes/{theme_id}" \
  -H "Authorization: Bearer $MB_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "updates": {}
}'

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/reports/themes/{theme_id}" \
  -H "Authorization: Bearer $MB_TEST_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "updates": {}
}'

Delete a report theme

reports.themes.delete

Deletes one of the organization's report themes; it stays 30 days in the trash. Templates, reports and instances that used it fall back to the default look until it is restored (it comes back with the same id): the dry run says how many use it. System themes cannot be deleted (409 system_theme_read_only). Requires edit access to Reports. Outside the screen it needs a dry run and a confirm_token, or a key with deletion enabled.

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

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

Permission

Edit in the module

MCP tool

reports_themes_deleteOn the full surface; on the compact one, mb_execute_operation with id: "reports.themes.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/reports/themes/{theme_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/reports/themes/{theme_id}" \
  -H "Authorization: Bearer $MB_TEST_KEY"