---
title: "Update a custom theme's name or definition."
method: PUT
path: "/custom-themes/{id}"
tags: ["Themes"]
---

# Update a custom theme's name or definition.

`PUT /custom-themes/{id}`

## Request

- Base URL: `https://www.livediagram.app/api`
- URL: `https://www.livediagram.app/api/custom-themes/{id}`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-Owner-Id`

## Path parameters

- `id` string, required

## Request body

- object
  - `name` string
  - `definition` CustomThemeDefinition
    - `backgroundColor` string, required
    - `backgroundOpacity` number
    - `backgroundPattern` 'grid' | 'blank' | 'lines' | 'crosshatch' | 'graph' | 'confetti' | 'stripes' | 'diagonal' | 'waves' | 'bricks' | 'isometric' | 'hexagonal' | 'engineering' | 'checkerboard' | 'sparkles' | 'eggs' | 'cobwebs' | 'snowflakes' | 'candy-stripes' | 'flow' | 'drift' | 'aurora' | 'ripple' | 'ribbons', required
    - `elementFill` string, nullable, required
    - `elementStroke` string, nullable, required
    - `elementText` string, nullable, required
    - `palette` object[]
      - `fill` string, required
      - `stroke` string, required
      - `text` string, required
    - `patternColor` string, required
    - `rootColor` object
      - `fill` string, required
      - `stroke` string, required
      - `text` string, required
    - `shapeColors` object
      - `action-card` object
        - `fill` string
        - `stroke` string
        - `text` string
      - `actor` object
        - `fill` string
        - `stroke` string
        - `text` string
      - `agenda` object
        - `fill` string
        - `stroke` string
        - `text` string
      - `avatar-pad` object
        - `fill` string
        - `stroke` string
        - `text` string
      - `badge` object
        - `fill` string
        - `stroke` string
        - `text` string
      - `banner` object
        - `fill` string
        - `stroke` string
        - `text` string
      - `bar-chart` object
        - `fill` string
        - `stroke` string
        - `text` string
      - `bookshelf` object
        - `fill` string
        - `stroke` string
        - `text` string
      - `boundary` object
        - `fill` string
        - `stroke` string
        - `text` string
      - `browser` object
        - `fill` string
        - `stroke` string
        - `text` string
      - `callout` object
        - `fill` string
        - `stroke` string
        - `text` string
      - `card` object
        - `fill` string
        - `stroke` string
        - `text` string
      - `chair` object
        - `fill` string
        - `stroke` string
        - `text` string
      - `checklist` object
        - `fill` string
        - `stroke` string
        - `text` string
      - `chevrons` object
        - `fill` string
        - `stroke` string
        - `text` string
      - `circle` object
        - `fill` string
        - `stroke` string
        - `text` string
      - `cloud` object
        - `fill` string
        - `stroke` string
        - `text` string
      - `code-block` object
        - `fill` string
        - `stroke` string
        - `text` string
      - `coffee-machine` object
        - `fill` string
        - `stroke` string
        - `text` string
      - `comment-pin` object
        - `fill` string
        - `stroke` string
        - `text` string
      - `cycle` object
        - `fill` string
        - `stroke` string
        - `text` string
      - `cylinder` object
        - `fill` string
        - `stroke` string
        - `text` string
      - `decision` object
        - `fill` string
        - `stroke` string
        - `text` string
      - `desk` object
        - `fill` string
        - `stroke` string
        - `text` string
      - `diagram-key` object
        - `fill` string
        - `stroke` string
        - `text` string
      - `diamond` object
        - `fill` string
        - `stroke` string
        - `text` string
      - `document` object
        - `fill` string
        - `stroke` string
        - `text` string
      - `done-check` object
        - `fill` string
        - `stroke` string
        - `text` string
      - `entity` object
        - `fill` string
        - `stroke` string
        - `text` string
      - `estimate` object
        - `fill` string
        - `stroke` string
        - `text` string
      - `fence` object
        - `fill` string
        - `stroke` string
        - `text` string
      - `final-state` object
        - `fill` string
        - `stroke` string
        - `text` string
      - `focus-button` object
        - `fill` string
        - `stroke` string
        - `text` string
      - `foldable` object
        - `fill` string
        - `stroke` string
        - `text` string
      - `frame` object
        - `fill` string
        - `stroke` string
        - `text` string
      - `hexagon` object
        - `fill` string
        - `stroke` string
        - `text` string
      - `hub` object
        - `fill` string
        - `stroke` string
        - `text` string
      - `icon` object
        - `fill` string
        - `stroke` string
        - `text` string
      - `idea-box` object
        - `fill` string
        - `stroke` string
        - `text` string
      - `lane` object
        - `fill` string
        - `stroke` string
        - `text` string
      - `laptop` object
        - `fill` string
        - `stroke` string
        - `text` string
      - `layer-stack` object
        - `fill` string
        - `stroke` string
        - `text` string
      - `legend` object
        - `fill` string
        - `stroke` string
        - `text` string
      - `line-chart` object
        - `fill` string
        - `stroke` string
        - `text` string
      - `meeting-table` object
        - `fill` string
        - `stroke` string
        - `text` string
      - `mind-node` object
        - `fill` string
        - `stroke` string
        - `text` string
      - `mode-button` object
        - `fill` string
        - `stroke` string
        - `text` string
      - `monitor` object
        - `fill` string
        - `stroke` string
        - `text` string
      - `onion` object
        - `fill` string
        - `stroke` string
        - `text` string
      - `page` object
        - `fill` string
        - `stroke` string
        - `text` string
      - `parallelogram` object
        - `fill` string
        - `stroke` string
        - `text` string
      - `phone` object
        - `fill` string
        - `stroke` string
        - `text` string
      - `picker` object
        - `fill` string
        - `stroke` string
        - `text` string
      - `pie-chart` object
        - `fill` string
        - `stroke` string
        - `text` string
      - `plan-board` object
        - `fill` string
        - `stroke` string
        - `text` string
      - `plan-card` object
        - `fill` string
        - `stroke` string
        - `text` string
      - `plan-sheet` object
        - `fill` string
        - `stroke` string
        - `text` string
      - `plan-view` object
        - `fill` string
        - `stroke` string
        - `text` string
      - `plant` object
        - `fill` string
        - `stroke` string
        - `text` string
      - `pointer-note` object
        - `fill` string
        - `stroke` string
        - `text` string
      - `portal` object
        - `fill` string
        - `stroke` string
        - `text` string
      - `process` object
        - `fill` string
        - `stroke` string
        - `text` string
      - `progress-bar` object
        - `fill` string
        - `stroke` string
        - `text` string
      - `progress-ring` object
        - `fill` string
        - `stroke` string
        - `text` string
      - `pyramid` object
        - `fill` string
        - `stroke` string
        - `text` string
      - `qa-board` object
        - `fill` string
        - `stroke` string
        - `text` string
      - `quiz` object
        - `fill` string
        - `stroke` string
        - `text` string
      - `rating` object
        - `fill` string
        - `stroke` string
        - `text` string
      - `reaction-pad` object
        - `fill` string
        - `stroke` string
        - `text` string
      - `reveal` object
        - `fill` string
        - `stroke` string
        - `text` string
      - `roll-call` object
        - `fill` string
        - `stroke` string
        - `text` string
      - `room` object
        - `fill` string
        - `stroke` string
        - `text` string
      - `rug` object
        - `fill` string
        - `stroke` string
        - `text` string
      - `sankey` object
        - `fill` string
        - `stroke` string
        - `text` string
      - `sequence` object
        - `fill` string
        - `stroke` string
        - `text` string
      - `session-button` object
        - `fill` string
        - `stroke` string
        - `text` string
      - `site-header` object
        - `fill` string
        - `stroke` string
        - `text` string
      - `smartwatch` object
        - `fill` string
        - `stroke` string
        - `text` string
      - `sofa` object
        - `fill` string
        - `stroke` string
        - `text` string
      - `speech-bubble` object
        - `fill` string
        - `stroke` string
        - `text` string
      - `square` object
        - `fill` string
        - `stroke` string
        - `text` string
      - `stack` object
        - `fill` string
        - `stroke` string
        - `text` string
      - `stadium` object
        - `fill` string
        - `stroke` string
        - `text` string
      - `star` object
        - `fill` string
        - `stroke` string
        - `text` string
      - `stat-row` object
        - `fill` string
        - `stroke` string
        - `text` string
      - `step` object
        - `fill` string
        - `stroke` string
        - `text` string
      - `sticker` object
        - `fill` string
        - `stroke` string
        - `text` string
      - `tab-window` object
        - `fill` string
        - `stroke` string
        - `text` string
      - `tablet` object
        - `fill` string
        - `stroke` string
        - `text` string
      - `temperature` object
        - `fill` string
        - `stroke` string
        - `text` string
      - `timeline-rail` object
        - `fill` string
        - `stroke` string
        - `text` string
      - `trapezoid` object
        - `fill` string
        - `stroke` string
        - `text` string
      - `triangle` object
        - `fill` string
        - `stroke` string
        - `text` string
      - `water-cooler` object
        - `fill` string
        - `stroke` string
        - `text` string

## Response `200`

Success.

- object
  - `theme` CustomTheme, required
    - `createdAt` number, required
    - `definition` CustomThemeDefinition, required
      - `backgroundColor` string, required
      - `backgroundOpacity` number
      - `backgroundPattern` 'grid' | 'blank' | 'lines' | 'crosshatch' | 'graph' | 'confetti' | 'stripes' | 'diagonal' | 'waves' | 'bricks' | 'isometric' | 'hexagonal' | 'engineering' | 'checkerboard' | 'sparkles' | 'eggs' | 'cobwebs' | 'snowflakes' | 'candy-stripes' | 'flow' | 'drift' | 'aurora' | 'ripple' | 'ribbons', required
      - `elementFill` string, nullable, required
      - `elementStroke` string, nullable, required
      - `elementText` string, nullable, required
      - `palette` object[]
        - `fill` string, required
        - `stroke` string, required
        - `text` string, required
      - `patternColor` string, required
      - `rootColor` object
        - `fill` string, required
        - `stroke` string, required
        - `text` string, required
      - `shapeColors` object
        - `action-card` object
          - `fill` string
          - `stroke` string
          - `text` string
        - `actor` object
          - `fill` string
          - `stroke` string
          - `text` string
        - `agenda` object
          - `fill` string
          - `stroke` string
          - `text` string
        - `avatar-pad` object
          - `fill` string
          - `stroke` string
          - `text` string
        - `badge` object
          - `fill` string
          - `stroke` string
          - `text` string
        - `banner` object
          - `fill` string
          - `stroke` string
          - `text` string
        - `bar-chart` object
          - `fill` string
          - `stroke` string
          - `text` string
        - `bookshelf` object
          - `fill` string
          - `stroke` string
          - `text` string
        - `boundary` object
          - `fill` string
          - `stroke` string
          - `text` string
        - `browser` object
          - `fill` string
          - `stroke` string
          - `text` string
        - `callout` object
          - `fill` string
          - `stroke` string
          - `text` string
        - `card` object
          - `fill` string
          - `stroke` string
          - `text` string
        - `chair` object
          - `fill` string
          - `stroke` string
          - `text` string
        - `checklist` object
          - `fill` string
          - `stroke` string
          - `text` string
        - `chevrons` object
          - `fill` string
          - `stroke` string
          - `text` string
        - `circle` object
          - `fill` string
          - `stroke` string
          - `text` string
        - `cloud` object
          - `fill` string
          - `stroke` string
          - `text` string
        - `code-block` object
          - `fill` string
          - `stroke` string
          - `text` string
        - `coffee-machine` object
          - `fill` string
          - `stroke` string
          - `text` string
        - `comment-pin` object
          - `fill` string
          - `stroke` string
          - `text` string
        - `cycle` object
          - `fill` string
          - `stroke` string
          - `text` string
        - `cylinder` object
          - `fill` string
          - `stroke` string
          - `text` string
        - `decision` object
          - `fill` string
          - `stroke` string
          - `text` string
        - `desk` object
          - `fill` string
          - `stroke` string
          - `text` string
        - `diagram-key` object
          - `fill` string
          - `stroke` string
          - `text` string
        - `diamond` object
          - `fill` string
          - `stroke` string
          - `text` string
        - `document` object
          - `fill` string
          - `stroke` string
          - `text` string
        - `done-check` object
          - `fill` string
          - `stroke` string
          - `text` string
        - `entity` object
          - `fill` string
          - `stroke` string
          - `text` string
        - `estimate` object
          - `fill` string
          - `stroke` string
          - `text` string
        - `fence` object
          - `fill` string
          - `stroke` string
          - `text` string
        - `final-state` object
          - `fill` string
          - `stroke` string
          - `text` string
        - `focus-button` object
          - `fill` string
          - `stroke` string
          - `text` string
        - `foldable` object
          - `fill` string
          - `stroke` string
          - `text` string
        - `frame` object
          - `fill` string
          - `stroke` string
          - `text` string
        - `hexagon` object
          - `fill` string
          - `stroke` string
          - `text` string
        - `hub` object
          - `fill` string
          - `stroke` string
          - `text` string
        - `icon` object
          - `fill` string
          - `stroke` string
          - `text` string
        - `idea-box` object
          - `fill` string
          - `stroke` string
          - `text` string
        - `lane` object
          - `fill` string
          - `stroke` string
          - `text` string
        - `laptop` object
          - `fill` string
          - `stroke` string
          - `text` string
        - `layer-stack` object
          - `fill` string
          - `stroke` string
          - `text` string
        - `legend` object
          - `fill` string
          - `stroke` string
          - `text` string
        - `line-chart` object
          - `fill` string
          - `stroke` string
          - `text` string
        - `meeting-table` object
          - `fill` string
          - `stroke` string
          - `text` string
        - `mind-node` object
          - `fill` string
          - `stroke` string
          - `text` string
        - `mode-button` object
          - `fill` string
          - `stroke` string
          - `text` string
        - `monitor` object
          - `fill` string
          - `stroke` string
          - `text` string
        - `onion` object
          - `fill` string
          - `stroke` string
          - `text` string
        - `page` object
          - `fill` string
          - `stroke` string
          - `text` string
        - `parallelogram` object
          - `fill` string
          - `stroke` string
          - `text` string
        - `phone` object
          - `fill` string
          - `stroke` string
          - `text` string
        - `picker` object
          - `fill` string
          - `stroke` string
          - `text` string
        - `pie-chart` object
          - `fill` string
          - `stroke` string
          - `text` string
        - `plan-board` object
          - `fill` string
          - `stroke` string
          - `text` string
        - `plan-card` object
          - `fill` string
          - `stroke` string
          - `text` string
        - `plan-sheet` object
          - `fill` string
          - `stroke` string
          - `text` string
        - `plan-view` object
          - `fill` string
          - `stroke` string
          - `text` string
        - `plant` object
          - `fill` string
          - `stroke` string
          - `text` string
        - `pointer-note` object
          - `fill` string
          - `stroke` string
          - `text` string
        - `portal` object
          - `fill` string
          - `stroke` string
          - `text` string
        - `process` object
          - `fill` string
          - `stroke` string
          - `text` string
        - `progress-bar` object
          - `fill` string
          - `stroke` string
          - `text` string
        - `progress-ring` object
          - `fill` string
          - `stroke` string
          - `text` string
        - `pyramid` object
          - `fill` string
          - `stroke` string
          - `text` string
        - `qa-board` object
          - `fill` string
          - `stroke` string
          - `text` string
        - `quiz` object
          - `fill` string
          - `stroke` string
          - `text` string
        - `rating` object
          - `fill` string
          - `stroke` string
          - `text` string
        - `reaction-pad` object
          - `fill` string
          - `stroke` string
          - `text` string
        - `reveal` object
          - `fill` string
          - `stroke` string
          - `text` string
        - `roll-call` object
          - `fill` string
          - `stroke` string
          - `text` string
        - `room` object
          - `fill` string
          - `stroke` string
          - `text` string
        - `rug` object
          - `fill` string
          - `stroke` string
          - `text` string
        - `sankey` object
          - `fill` string
          - `stroke` string
          - `text` string
        - `sequence` object
          - `fill` string
          - `stroke` string
          - `text` string
        - `session-button` object
          - `fill` string
          - `stroke` string
          - `text` string
        - `site-header` object
          - `fill` string
          - `stroke` string
          - `text` string
        - `smartwatch` object
          - `fill` string
          - `stroke` string
          - `text` string
        - `sofa` object
          - `fill` string
          - `stroke` string
          - `text` string
        - `speech-bubble` object
          - `fill` string
          - `stroke` string
          - `text` string
        - `square` object
          - `fill` string
          - `stroke` string
          - `text` string
        - `stack` object
          - `fill` string
          - `stroke` string
          - `text` string
        - `stadium` object
          - `fill` string
          - `stroke` string
          - `text` string
        - `star` object
          - `fill` string
          - `stroke` string
          - `text` string
        - `stat-row` object
          - `fill` string
          - `stroke` string
          - `text` string
        - `step` object
          - `fill` string
          - `stroke` string
          - `text` string
        - `sticker` object
          - `fill` string
          - `stroke` string
          - `text` string
        - `tab-window` object
          - `fill` string
          - `stroke` string
          - `text` string
        - `tablet` object
          - `fill` string
          - `stroke` string
          - `text` string
        - `temperature` object
          - `fill` string
          - `stroke` string
          - `text` string
        - `timeline-rail` object
          - `fill` string
          - `stroke` string
          - `text` string
        - `trapezoid` object
          - `fill` string
          - `stroke` string
          - `text` string
        - `triangle` object
          - `fill` string
          - `stroke` string
          - `text` string
        - `water-cooler` object
          - `fill` string
          - `stroke` string
          - `text` string
    - `id` string, required
    - `name` string, required
    - `ownerId` string, required
    - `updatedAt` number, required

## Other responses

- `400`: Error.
- `401`: Error.
- `403`: Error.
- `404`: Error.
- `413`: Error.
- `429`: Rate limited. Back off and retry.

---

[API](https://skmtc.dev/livediagram/apis/livediagram-api.md) · [All operations](https://skmtc.dev/livediagram/apis/livediagram-api/llms.txt) · [OpenAPI document](https://skmtc.dev/livediagram/apis/livediagram-api/revisions/f286d27acfd2?raw)