v1

latestOpenAPI 3.0.0Apache 2.0 License2026-07-141341,3811.0 MB

Creates a theme.

A theme is set of configuration options for color and layout. Themes apply to analyses and dashboards. For more information, see Using Themes in Amazon QuickSight in the Amazon QuickSight User Guide.

post/accounts/{AwsAccountId}/themes/{ThemeId}

Path parameters

AwsAccountIdstring required

The ID of the Amazon Web Services account where you want to store the new theme.

ThemeIdstring required

An ID for the theme that you want to create. The theme ID is unique per Amazon Web Services Region in each Amazon Web Services account.

Request body

Namestring required

A display name for the theme.

BaseThemeIdstring required

The ID of the theme that a custom theme will inherit from. All themes inherit from one of the starting themes defined by Amazon QuickSight. For a list of the starting themes, use <code>ListThemes</code> or choose <b>Themes</b> from within an analysis.

VersionDescriptionstring

A description of the first version of the theme that you're creating. Every time <code>UpdateTheme</code> is called, a new version is created. Each version of the theme has a description of the version in the <code>VersionDescription</code> field.

Response

Success

Arnstring

The Amazon Resource Name (ARN) for the theme.

VersionArnstring

The Amazon Resource Name (ARN) for the new theme.

ThemeIdstring

The ID of the theme.

CreationStatus'CREATION_IN_PROGRESS' | 'CREATION_SUCCESSFUL' | 'CREATION_FAILED' | 'UPDATE_IN_PROGRESS' | 'UPDATE_SUCCESSFUL' | 'UPDATE_FAILED' | 'DELETED'

The theme creation status.

Statusinteger

The HTTP status of the request.

RequestIdstring

The Amazon Web Services request ID for this operation.