Temas

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.

Escopo

reports:read

Permissão

Ver o módulo

Tool do MCP

reports_themes_listNa superfície completa; na compacta, mb_execute_operation com id: "reports.themes.list".

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

Parâmetros

Resposta

Erros

Exemplo

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

Escopo

reports:read

Permissão

Ver o módulo

Tool do MCP

reports_themes_getNa superfície completa; na compacta, mb_execute_operation com id: "reports.themes.get".

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

Parâmetros

Resposta

Erros

Exemplo

curl "https://api.mb-suite.com/v1/reports/themes/{theme_id}" \
  -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/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.

Escopo

reports:write

Permissão

Editar no módulo

Tool do MCP

reports_themes_createNa superfície completa; na compacta, mb_execute_operation com id: "reports.themes.create".

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

Parâmetros

Resposta

Erros

Exemplo

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": {}
}'

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

Escopo

reports:write

Permissão

Editar no módulo

Tool do MCP

reports_themes_updateNa superfície completa; na compacta, mb_execute_operation com id: "reports.themes.update".

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

Parâmetros

Resposta

Erros

Exemplo

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": {}
}'

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

Com uma API key, este DELETE roda direto: o registro fica 30 dias na lixeira e a resposta traz o seu trash_item_id. Com um token OAuth, e pelo MCP, pede dry_run → confirm_token.

Escopo

reports:write e «Permitir exclusões» (reports:delete no OAuth)

Permissão

Editar no módulo

Tool do MCP

reports_themes_deleteNa superfície completa; na compacta, mb_execute_operation com id: "reports.themes.delete".

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

Parâmetros

Resposta

Erros

Exemplo

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