Own AWS? Customize your docs with AI search, analytics, and more.

POST

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

http://quicksight.{region}.amazonaws.com/accounts/{AwsAccountId}/themes/{ThemeId}

Creates a theme. A theme is set of configuration options for color and layout. Themes apply to analyses and dashboards. For more information, see <a href="https://docs.aws.amazon.com/quicksight/latest/user/themes-in-quicksight.html">Using Themes in Amazon QuickSight</a> in the Amazon QuickSight User Guide.

Access Token Required: API Key

Path Parameters

AwsAccountIdstringrequired

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

ThemeIdstringrequired

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.

Body Params

Namestringrequired

A display name for the theme.

Tagsarray

A map of the key-value pairs for the resource tag or tags that you want to add to the resource.

BaseThemeIdstringrequired

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 Themes from within an analysis.

Permissionsarray

A valid grouping of resource permissions to apply to the new theme.

Configurationobjectrequired

The theme configuration. This configuration contains all of the display properties for a theme.

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.

Responses

{
  "success": true,
  "data": {
    "id": "abc123",
    "created_at": "2025-01-01T00:00:00Z"
  }
}

{
  "success": false,
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Invalid request parameters"
  }
}

Language

CredentialsAPI KEY

API Key

Enter token below to save for later

cURL Request

1curl --request POST \
2     --url 'http://quicksight.{region}.amazonaws.com/accounts/{AwsAccountId}/themes/{ThemeId}' \
3     --header 'accept: application/json' \
4     --header 'content-type: application/json'

Response

1{
2  "success": true,
3  "data": {
4    "id": "abc123",
5    "created_at": "2025-01-01T00:00:00Z"
6  }
7}