# Update Analytics Theme

Change a theme. Send only the style options you change; null clears one. Every page and folder wearing the theme changes with it.

`PUT https://connect.mindcloud.co/v2/analytics/themes/:themeId`

Permissions: `analytics:page:create`.

## Parameters

### Path

- `themeId` (string, required): The theme id, from List Analytics Themes.

### Headers

- `X-Company-Id` (string): Optional. The id of the organization to act in. Leave it out to act in the API key's own organization. Here a key acts in another organization only as one of its members: with "Use this key across all of your organizations" on, in an organization its creator belongs to with a role. Child organizations and MindCloud staff access do not reach this endpoint. Every response's X-Company-Id header names the organization it acted in. See [Organizations](https://mindcloud.co/docs/api/rest/introduction/organizations).

### Body

- `name` (string): The new theme name.
  The new theme name, 1 to 255 characters.
- `style` (object): The style options to change; null clears one.
  The look, option by option. An option left out or null uses the default.
  - `fontFamily` (string): Font family. One of: "Inter, sans-serif" (Inter), ""SF Pro Display", -apple-system, sans-serif" (SF Pro Display), ""Helvetica Neue", Helvetica, sans-serif" (Helvetica Neue), "system-ui, sans-serif" (System UI), ""Segoe UI", sans-serif" (Segoe UI), "Roboto, sans-serif" (Roboto), ""Open Sans", sans-serif" (Open Sans), "Lato, sans-serif" (Lato), ""Source Sans 3", sans-serif" (Source Sans), ""IBM Plex Sans", sans-serif" (IBM Plex Sans), ""Atkinson Hyperlegible", sans-serif" (Atkinson Hyperlegible), "Georgia, "Times New Roman", serif" (Georgia), ""IBM Plex Mono", monospace" (IBM Plex Mono). null or left out uses the default.
    Allowed values:
      - `Inter, sans-serif`
      - `"SF Pro Display", -apple-system, sans-serif`
      - `"Helvetica Neue", Helvetica, sans-serif`
      - `system-ui, sans-serif`
      - `"Segoe UI", sans-serif`
      - `Roboto, sans-serif`
      - `"Open Sans", sans-serif`
      - `Lato, sans-serif`
      - `"Source Sans 3", sans-serif`
      - `"IBM Plex Sans", sans-serif`
      - `"Atkinson Hyperlegible", sans-serif`
      - `Georgia, "Times New Roman", serif`
      - `"IBM Plex Mono", monospace`
  - `fontScale` (string): Font size. One of: "0.9" (Small), "1" (Medium), "1.1" (Large), "1.25" (Extra Large). null or left out uses the default.
    Allowed values:
      - `1`
      - `0.9`
      - `1.1`
      - `1.25`
  - `panelTitleWeight` (string): Panel title weight. One of: "regular" (Regular), "medium" (Medium), "bold" (Bold). null or left out uses the default.
    Allowed values:
      - `regular`
      - `medium`
      - `bold`
  - `pageTitleSize` (string): Page title size. One of: "compact" (Compact), "regular" (Regular), "large" (Large). null or left out uses the default.
    Allowed values:
      - `compact`
      - `regular`
      - `large`
  - `seriesColors` (array of objects): Series colors: up to 8 light and dark color pairs, in the order charts hand colors out (the first is the first series).
  - `statusColors` (object): Status colors: a light and dark color pair for success (Success), warning (Warning), warningBright (Caution), failure (Failure).
    - `success` (object): Success: a light and dark color pair, or null for the default.
      - `light` (string, required): The color in light mode, as hex like #2563eb.
      - `dark` (string, required): The color in dark mode, as hex like #2563eb.
    - `warning` (object): Warning: a light and dark color pair, or null for the default.
      - `light` (string, required): The color in light mode, as hex like #2563eb.
      - `dark` (string, required): The color in dark mode, as hex like #2563eb.
    - `warningBright` (object): Caution: a light and dark color pair, or null for the default.
      - `light` (string, required): The color in light mode, as hex like #2563eb.
      - `dark` (string, required): The color in dark mode, as hex like #2563eb.
    - `failure` (object): Failure: a light and dark color pair, or null for the default.
      - `light` (string, required): The color in light mode, as hex like #2563eb.
      - `dark` (string, required): The color in dark mode, as hex like #2563eb.
  - `chartGridlines` (string): Chart gridlines. One of: "off" (Off), "dashed" (Dashed), "solid" (Solid). null or left out uses the default.
    Allowed values:
      - `off`
      - `dashed`
      - `solid`
  - `chartAreaFill` (string): Area fill. One of: "none" (None), "light" (Light), "solid" (Solid). null or left out uses the default.
    Allowed values:
      - `none`
      - `light`
      - `solid`
  - `chartCurve` (string): Line curve. One of: "straight" (Straight), "smooth" (Smooth), "natural" (Curved). null or left out uses the default.
    Allowed values:
      - `straight`
      - `smooth`
      - `natural`
  - `chartPoints` (string): Point marks. One of: "shown" (Shown), "hidden" (Hidden). null or left out uses the default.
    Allowed values:
      - `shown`
      - `hidden`
  - `chartValues` (string): Value labels. One of: "shown" (Shown), "hidden" (Hidden). null or left out uses the default.
    Allowed values:
      - `shown`
      - `hidden`
  - `chartLegend` (string): Legend. One of: "auto" (Auto), "shown" (Shown), "hidden" (Hidden). null or left out uses the default.
    Allowed values:
      - `auto`
      - `shown`
      - `hidden`
  - `numberFormat` (string): Number format. One of: "point" (1,234.56), "comma" (1.234,56), "space" (1 234,56). null or left out uses the default.
    Allowed values:
      - `point`
      - `comma`
      - `space`
  - `numberCompact` (string): Compact numbers. One of: "auto" (Auto), "always" (Always), "never" (Never). null or left out uses the default.
    Allowed values:
      - `auto`
      - `always`
      - `never`
  - `dateOrder` (string): Date order. One of: "monthFirst" (Jan 6, 2026), "dayFirst" (6 Jan 2026). null or left out uses the default.
    Allowed values:
      - `monthFirst`
      - `dayFirst`
  - `dateStyle` (string): Date style. One of: "short" (Short), "medium" (Medium), "numeric" (Numeric). null or left out uses the default.
    Allowed values:
      - `short`
      - `medium`
      - `numeric`
  - `panelCorners` (string): Panel corners. One of: "square" (Square), "rounded" (Rounded), "soft" (Soft). null or left out uses the default.
    Allowed values:
      - `square`
      - `rounded`
      - `soft`
  - `panelElevation` (string): Panel elevation. One of: "none" (None), "hairline" (Hairline), "raised" (Raised). null or left out uses the default.
    Allowed values:
      - `none`
      - `hairline`
      - `raised`
  - `panelGap` (string): Panel gap. One of: "none" (None), "tight" (Tight), "regular" (Regular), "wide" (Wide). null or left out uses the default.
    Allowed values:
      - `none`
      - `tight`
      - `regular`
      - `wide`
  - `panelPadding` (string): Panel padding. One of: "compact" (Compact), "regular" (Regular), "comfortable" (Comfortable). null or left out uses the default.
    Allowed values:
      - `compact`
      - `regular`
      - `comfortable`
  - `tableDensity` (string): Table density. One of: "compact" (Compact), "regular" (Regular), "comfortable" (Comfortable). null or left out uses the default.
    Allowed values:
      - `compact`
      - `regular`
      - `comfortable`
  - `pageBackground` (object): Page background: a light and dark color pair for page (Page).
    - `page` (object): Page: a light and dark color pair, or null for the default.
      - `light` (string, required): The color in light mode, as hex like #2563eb.
      - `dark` (string, required): The color in dark mode, as hex like #2563eb.
  - `panelFill` (object): Panel fill: a light and dark color pair for panel (Panel).
    - `panel` (object): Panel: a light and dark color pair, or null for the default.
      - `light` (string, required): The color in light mode, as hex like #2563eb.
      - `dark` (string, required): The color in dark mode, as hex like #2563eb.
  - `ink` (object): Ink: a light and dark color pair for ink (Ink).
    - `ink` (object): Ink: a light and dark color pair, or null for the default.
      - `light` (string, required): The color in light mode, as hex like #2563eb.
      - `dark` (string, required): The color in dark mode, as hex like #2563eb.
  - `lineColor` (object): Line color: a light and dark color pair for line (Line).
    - `line` (object): Line: a light and dark color pair, or null for the default.
      - `light` (string, required): The color in light mode, as hex like #2563eb.
      - `dark` (string, required): The color in dark mode, as hex like #2563eb.
  - `brandHeaderColor` (object): Publication header color: a light and dark color pair for header (Header).
    - `header` (object): Header: a light and dark color pair, or null for the default.
      - `light` (string, required): The color in light mode, as hex like #2563eb.
      - `dark` (string, required): The color in dark mode, as hex like #2563eb.
  - `cirraMark` (string): Cirra mark. One of: "shown" (Shown), "hidden" (Hidden). null or left out uses the default.
    Allowed values:
      - `shown`
      - `hidden`
- `isDefault` (boolean): true makes new pages start with this theme; false stops it being the default.
  true makes new pages start with this theme; false stops it being the default, so new pages wear the plain Cirra look.

## Example request

```bash
curl --request PUT \
  --url 'https://connect.mindcloud.co/v2/analytics/themes/Th6Np2Vx8LcQ' \
  --header 'Authorization: Bearer $MINDCLOUD_API_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
  "name": "Board deck (2027)",
  "style": {
    "fontFamily": "Inter, sans-serif",
    "panelCorners": "soft"
  },
  "isDefault": true
}'
```

## Response fields

- `id` (string): Unique id of the theme.
- `name` (string): The theme name.
- `isDefault` (boolean): Whether new pages in the organization start with this theme. When no theme is the default, new pages wear the plain Cirra look.
- `style` (object): The look the theme gives a page, option by option. An option it leaves out keeps the default.
  - `fontFamily` (string): Font family. One of: "Inter, sans-serif" (Inter), ""SF Pro Display", -apple-system, sans-serif" (SF Pro Display), ""Helvetica Neue", Helvetica, sans-serif" (Helvetica Neue), "system-ui, sans-serif" (System UI), ""Segoe UI", sans-serif" (Segoe UI), "Roboto, sans-serif" (Roboto), ""Open Sans", sans-serif" (Open Sans), "Lato, sans-serif" (Lato), ""Source Sans 3", sans-serif" (Source Sans), ""IBM Plex Sans", sans-serif" (IBM Plex Sans), ""Atkinson Hyperlegible", sans-serif" (Atkinson Hyperlegible), "Georgia, "Times New Roman", serif" (Georgia), ""IBM Plex Mono", monospace" (IBM Plex Mono). Absent when the default is used.
    Allowed values:
      - `Inter, sans-serif`
      - `"SF Pro Display", -apple-system, sans-serif`
      - `"Helvetica Neue", Helvetica, sans-serif`
      - `system-ui, sans-serif`
      - `"Segoe UI", sans-serif`
      - `Roboto, sans-serif`
      - `"Open Sans", sans-serif`
      - `Lato, sans-serif`
      - `"Source Sans 3", sans-serif`
      - `"IBM Plex Sans", sans-serif`
      - `"Atkinson Hyperlegible", sans-serif`
      - `Georgia, "Times New Roman", serif`
      - `"IBM Plex Mono", monospace`
  - `fontScale` (string): Font size. One of: "0.9" (Small), "1" (Medium), "1.1" (Large), "1.25" (Extra Large). Absent when the default is used.
    Allowed values:
      - `0.9`
      - `1`
      - `1.1`
      - `1.25`
  - `panelTitleWeight` (string): Panel title weight. One of: "regular" (Regular), "medium" (Medium), "bold" (Bold). Absent when the default is used.
    Allowed values:
      - `regular`
      - `medium`
      - `bold`
  - `pageTitleSize` (string): Page title size. One of: "compact" (Compact), "regular" (Regular), "large" (Large). Absent when the default is used.
    Allowed values:
      - `compact`
      - `regular`
      - `large`
  - `seriesColors` (array): Series colors: light and dark color pairs in the order charts hand colors out; a null entry uses that slot's default. Absent when the defaults are used.
    - `light` (string): The color in light mode, as hex.
    - `dark` (string): The color in dark mode, as hex.
  - `statusColors` (object): Status colors, a light and dark color pair per entry. Absent when the defaults are used.
    - `success` (object): Success, or null for the default.
      - `light` (string): The color in light mode, as hex.
      - `dark` (string): The color in dark mode, as hex.
    - `warning` (object): Warning, or null for the default.
      - `light` (string): The color in light mode, as hex.
      - `dark` (string): The color in dark mode, as hex.
    - `warningBright` (object): Caution, or null for the default.
      - `light` (string): The color in light mode, as hex.
      - `dark` (string): The color in dark mode, as hex.
    - `failure` (object): Failure, or null for the default.
      - `light` (string): The color in light mode, as hex.
      - `dark` (string): The color in dark mode, as hex.
  - `chartGridlines` (string): Chart gridlines. One of: "off" (Off), "dashed" (Dashed), "solid" (Solid). Absent when the default is used.
    Allowed values:
      - `off`
      - `dashed`
      - `solid`
  - `chartAreaFill` (string): Area fill. One of: "none" (None), "light" (Light), "solid" (Solid). Absent when the default is used.
    Allowed values:
      - `none`
      - `light`
      - `solid`
  - `chartCurve` (string): Line curve. One of: "straight" (Straight), "smooth" (Smooth), "natural" (Curved). Absent when the default is used.
    Allowed values:
      - `straight`
      - `smooth`
      - `natural`
  - `chartPoints` (string): Point marks. One of: "shown" (Shown), "hidden" (Hidden). Absent when the default is used.
    Allowed values:
      - `shown`
      - `hidden`
  - `chartValues` (string): Value labels. One of: "shown" (Shown), "hidden" (Hidden). Absent when the default is used.
    Allowed values:
      - `shown`
      - `hidden`
  - `chartLegend` (string): Legend. One of: "auto" (Auto), "shown" (Shown), "hidden" (Hidden). Absent when the default is used.
    Allowed values:
      - `auto`
      - `shown`
      - `hidden`
  - `numberFormat` (string): Number format. One of: "point" (1,234.56), "comma" (1.234,56), "space" (1 234,56). Absent when the default is used.
    Allowed values:
      - `point`
      - `comma`
      - `space`
  - `numberCompact` (string): Compact numbers. One of: "auto" (Auto), "always" (Always), "never" (Never). Absent when the default is used.
    Allowed values:
      - `auto`
      - `always`
      - `never`
  - `dateOrder` (string): Date order. One of: "monthFirst" (Jan 6, 2026), "dayFirst" (6 Jan 2026). Absent when the default is used.
    Allowed values:
      - `monthFirst`
      - `dayFirst`
  - `dateStyle` (string): Date style. One of: "short" (Short), "medium" (Medium), "numeric" (Numeric). Absent when the default is used.
    Allowed values:
      - `short`
      - `medium`
      - `numeric`
  - `panelCorners` (string): Panel corners. One of: "square" (Square), "rounded" (Rounded), "soft" (Soft). Absent when the default is used.
    Allowed values:
      - `square`
      - `rounded`
      - `soft`
  - `panelElevation` (string): Panel elevation. One of: "none" (None), "hairline" (Hairline), "raised" (Raised). Absent when the default is used.
    Allowed values:
      - `none`
      - `hairline`
      - `raised`
  - `panelGap` (string): Panel gap. One of: "none" (None), "tight" (Tight), "regular" (Regular), "wide" (Wide). Absent when the default is used.
    Allowed values:
      - `none`
      - `tight`
      - `regular`
      - `wide`
  - `panelPadding` (string): Panel padding. One of: "compact" (Compact), "regular" (Regular), "comfortable" (Comfortable). Absent when the default is used.
    Allowed values:
      - `compact`
      - `regular`
      - `comfortable`
  - `tableDensity` (string): Table density. One of: "compact" (Compact), "regular" (Regular), "comfortable" (Comfortable). Absent when the default is used.
    Allowed values:
      - `compact`
      - `regular`
      - `comfortable`
  - `pageBackground` (object): Page background, a light and dark color pair per entry. Absent when the defaults are used.
    - `page` (object): Page, or null for the default.
      - `light` (string): The color in light mode, as hex.
      - `dark` (string): The color in dark mode, as hex.
  - `panelFill` (object): Panel fill, a light and dark color pair per entry. Absent when the defaults are used.
    - `panel` (object): Panel, or null for the default.
      - `light` (string): The color in light mode, as hex.
      - `dark` (string): The color in dark mode, as hex.
  - `ink` (object): Ink, a light and dark color pair per entry. Absent when the defaults are used.
    - `ink` (object): Ink, or null for the default.
      - `light` (string): The color in light mode, as hex.
      - `dark` (string): The color in dark mode, as hex.
  - `lineColor` (object): Line color, a light and dark color pair per entry. Absent when the defaults are used.
    - `line` (object): Line, or null for the default.
      - `light` (string): The color in light mode, as hex.
      - `dark` (string): The color in dark mode, as hex.
  - `brandHeaderColor` (object): Publication header color, a light and dark color pair per entry. Absent when the defaults are used.
    - `header` (object): Header, or null for the default.
      - `light` (string): The color in light mode, as hex.
      - `dark` (string): The color in dark mode, as hex.
  - `cirraMark` (string): Cirra mark. One of: "shown" (Shown), "hidden" (Hidden). Absent when the default is used.
    Allowed values:
      - `shown`
      - `hidden`
- `createdOn` (date): When the theme was created.
- `updatedOn` (date): When the theme was last changed.