---
title: "PUT /accounts/{AwsAccountId}/themes/{ThemeId}"
method: PUT
path: "/accounts/{AwsAccountId}/themes/{ThemeId}"
---

# PUT /accounts/{AwsAccountId}/themes/{ThemeId}

`PUT /accounts/{AwsAccountId}/themes/{ThemeId}`

Updates a theme.

## Path parameters

- `AwsAccountId` string, required
- `ThemeId` string, required

## Request body

- object
  - `Name` string — The name for the theme.
  - `BaseThemeId` string, required — The theme ID, defined by Amazon QuickSight, that a custom theme inherits from. All themes initially inherit from a default Amazon QuickSight theme.
  - `VersionDescription` string — A description of the theme version that you're updating Every time that you call <code>UpdateTheme</code>, you create a new version of the theme. Each version of the theme maintains a description of the version in <code>VersionDescription</code>.
  - `Configuration` object — The theme configuration. This configuration contains all of the display properties for a theme.
    - `DataColorPalette` object — Color properties that apply to chart data colors.
      - `Colors` HexColor[] — The hexadecimal codes for the colors.
      - `MinMaxGradient` HexColor[] — The minimum and maximum hexadecimal codes that describe a color gradient.
      - `EmptyFillColor` string — The hexadecimal code of a color that applies to charts where a lack of data is highlighted.
    - `UIColorPalette` object — Color properties that apply to the UI and to charts, excluding the colors that apply to data.
      - `PrimaryForeground` string — The color of text and other foreground elements that appear over the primary background regions, such as grid lines, borders, table banding, icons, and so on.
      - `PrimaryBackground` string — The background color that applies to visuals and other high emphasis UI.
      - `SecondaryForeground` string — The foreground color that applies to any sheet title, sheet control text, or UI that appears over the secondary background.
      - `SecondaryBackground` string — The background color that applies to the sheet background and sheet controls.
      - `Accent` string — This color is that applies to selected states and buttons.
      - `AccentForeground` string — The foreground color that applies to any text or other elements that appear over the accent color.
      - `Danger` string — The color that applies to error messages.
      - `DangerForeground` string — The foreground color that applies to any text or other elements that appear over the error color.
      - `Warning` string — This color that applies to warning and informational messages.
      - `WarningForeground` string — The foreground color that applies to any text or other elements that appear over the warning color.
      - `Success` string — The color that applies to success messages, for example the check mark for a successful download.
      - `SuccessForeground` string — The foreground color that applies to any text or other elements that appear over the success color.
      - `Dimension` string — The color that applies to the names of fields that are identified as dimensions.
      - `DimensionForeground` string — The foreground color that applies to any text or other elements that appear over the dimension color.
      - `Measure` string — The color that applies to the names of fields that are identified as measures.
      - `MeasureForeground` string — The foreground color that applies to any text or other elements that appear over the measure color.
    - `Sheet` object — Display options related to sheets.
      - `Tile` object — The display options for tiles.
        - `Border` object — The border around a tile.
          - `Show` boolean — The option to enable display of borders for visuals.
      - `TileLayout` object — The layout options for tiles.
        - `Gutter` object — The gutter settings that apply between tiles.
          - `Show` boolean — This Boolean value controls whether to display a gutter space between sheet tiles.
        - `Margin` object — The margin settings that apply around the outside edge of sheets.
          - `Show` boolean — This Boolean value controls whether to display sheet margins.
    - `Typography` Typography — Determines the typography options.
      - `FontFamilies` Font[] — Determines the list of font families.
        - `FontFamily` string — Determines the font family settings.

## Response `200`

Success

- UpdateThemeResponse
  - `ThemeId` string — The ID for the theme.
  - `Arn` string — The Amazon Resource Name (ARN) for the theme.
  - `VersionArn` string — The Amazon Resource Name (ARN) for the new version of the theme.
  - `CreationStatus` 'CREATION_IN_PROGRESS' | 'CREATION_SUCCESSFUL' | 'CREATION_FAILED' | 'UPDATE_IN_PROGRESS' | 'UPDATE_SUCCESSFUL' | 'UPDATE_FAILED' | 'DELETED' — The creation status of the theme.
  - `Status` integer — The HTTP status of the request.
  - `RequestId` string — The Amazon Web Services request ID for this operation.

## Other responses

- `480` — AccessDeniedException
- `481` — InvalidParameterValueException
- `482` — LimitExceededException
- `483` — ResourceExistsException
- `484` — ResourceNotFoundException
- `485` — ThrottlingException
- `486` — UnsupportedUserEditionException
- `487` — InternalFailureException

---

[API](https://skmtc.net/aws/apis/quicksight.md) · [All operations](https://skmtc.net/aws/apis/quicksight/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws/quicksight/versions/2f2bbd7e70ca/schema)