---
updatedAt: 2026-09-28T19:27:22.000Z
agentTools:
  projectIndex: https://docs.wistia.com/llms.txt
---

# Get Brand Kit Colors

Retrieves the current account's brand colors for the Wistia desktop
app's background picker.

`colors` lists solid colors: every brand kit's color tokens (the colors
the web editor offers as "Brand colors"), then each brand's primary and
page background color when it is solid, default brand first. Values are
six-digit hex strings, and a repeated color is listed once. Tokens whose
value isn't a hex color are left out. An account without a brand kit
gets its player color in place of the kit, which is what its default
brand kit would hold.

`brand_gradients` lists each brand's primary and page background color
that is set to a gradient, as color stops sorted by position, default
brand first. Stops whose color isn't a hex color are left out, and a
gradient with fewer than two hex stops left isn't listed.

## Requires api token with one of the following permissions
```
(any scope allowed)
```

Tokens with the "Act with a team member's permissions" permission
(`all:delegate_to_contact_permissions` scope) can also be used. Requests
made with such a token are authorized using the permissions of the
contact assigned to the token.

An [expiring access token](https://docs.wistia.com/reference/post_expiring-token)
created with the `all:delegate_to_contact_permissions` scope can also be
used, whatever its authorizations name; the colors belong to the token's
own account.


# OpenAPI definition

````json
{
  "openapi": "3.1.1",
  "info": {
    "title": "Data API",
    "description": "Wistia Data API",
    "version": "2026.09.0"
  },
  "servers": [
    {
      "url": "https://api.wistia.com/modern"
    }
  ],
  "security": [
    {
      "BearerAuth": []
    }
  ],
  "tags": [
    {
      "name": "Account"
    }
  ],
  "paths": {
    "/brand_kit_colors": {
      "get": {
        "operationId": "getBrandKitColors",
        "summary": "Get Brand Kit Colors",
        "x-speakeasy-group": "account",
        "x-speakeasy-name-override": "getBrandKitColors",
        "description": "Retrieves the current account's brand colors for the Wistia desktop\napp's background picker.\n\n`colors` lists solid colors: every brand kit's color tokens (the colors\nthe web editor offers as \"Brand colors\"), then each brand's primary and\npage background color when it is solid, default brand first. Values are\nsix-digit hex strings, and a repeated color is listed once. Tokens whose\nvalue isn't a hex color are left out. An account without a brand kit\ngets its player color in place of the kit, which is what its default\nbrand kit would hold.\n\n`brand_gradients` lists each brand's primary and page background color\nthat is set to a gradient, as color stops sorted by position, default\nbrand first. Stops whose color isn't a hex color are left out, and a\ngradient with fewer than two hex stops left isn't listed.\n\n## Requires api token with one of the following permissions\n```\n(any scope allowed)\n```\n\nTokens with the \"Act with a team member's permissions\" permission\n(`all:delegate_to_contact_permissions` scope) can also be used. Requests\nmade with such a token are authorized using the permissions of the\ncontact assigned to the token.\n\nAn [expiring access token](https://docs.wistia.com/reference/post_expiring-token)\ncreated with the `all:delegate_to_contact_permissions` scope can also be\nused, whatever its authorizations name; the colors belong to the token's\nown account.\n",
        "responses": {
          "200": {
            "description": "Successful response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "description": "The current account's brand colors, from its brand kits and its brands.",
                  "unevaluatedProperties": false,
                  "properties": {
                    "colors": {
                      "description": "Solid brand colors: every brand kit's color tokens (newest kit\nfirst, tokens in the order they were added), then each brand's\nprimary and page background color when it is a solid color\n(default brand first). A color already listed isn't repeated.\nEmpty when the account has none.\n",
                      "type": "array",
                      "items": {
                        "type": "object",
                        "unevaluatedProperties": false,
                        "properties": {
                          "name": {
                            "description": "The brand kit token's name, or the brand and field (e.g. \"Acme primary color\").",
                            "type": "string"
                          },
                          "value": {
                            "description": "Six-digit hex color with a leading \"#\" (e.g. \"#2949E5\").",
                            "type": "string"
                          }
                        },
                        "required": [
                          "name",
                          "value"
                        ]
                      }
                    },
                    "brand_gradients": {
                      "description": "Each brand's primary and page background color that is set to a\ngradient, default brand first. Stops whose color isn't a hex color\nare left out, and a gradient with fewer than two hex stops left\nisn't listed. Empty when none are gradients.\n",
                      "type": "array",
                      "items": {
                        "type": "object",
                        "unevaluatedProperties": false,
                        "properties": {
                          "name": {
                            "description": "The brand and field the gradient comes from (e.g. \"Acme primary color\").",
                            "type": "string"
                          },
                          "stops": {
                            "description": "The gradient's color stops, sorted by position.",
                            "type": "array",
                            "items": {
                              "type": "object",
                              "unevaluatedProperties": false,
                              "properties": {
                                "color": {
                                  "description": "Six-digit hex color with a leading \"#\".",
                                  "type": "string"
                                },
                                "position": {
                                  "description": "Where the stop sits along the gradient, as stored on the brand.",
                                  "type": "number"
                                }
                              },
                              "required": [
                                "color",
                                "position"
                              ]
                            }
                          }
                        },
                        "required": [
                          "name",
                          "stops"
                        ]
                      }
                    }
                  },
                  "required": [
                    "colors",
                    "brand_gradients"
                  ]
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized, invalid or missing token",
            "content": {
              "application/json": {
                "schema": {
                  "unevaluatedProperties": false,
                  "type": "object",
                  "properties": {
                    "code": {
                      "description": "A machine-readable identifier for the specific authorization failure.",
                      "type": "string",
                      "enum": [
                        "unauthorized_credentials",
                        "account_inactive",
                        "unauthorized_scope",
                        "unauthorized_params"
                      ]
                    },
                    "error": {
                      "type": "string",
                      "examples": [
                        "Invalid credentials."
                      ]
                    }
                  }
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "unevaluatedProperties": false,
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "string",
                      "examples": [
                        "Internal server error"
                      ]
                    }
                  }
                }
              }
            }
          }
        },
        "tags": [
          "Account"
        ],
        "parameters": [
          {
            "name": "X-Wistia-API-Version",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "default": "2026-09"
            }
          }
        ],
        "x-readme": {
          "code-samples": [
            {
              "name": "Typescript (SDK)",
              "language": "javascript",
              "code": "import { Wistia } from \"@wistia/wistia-api-client\";\n\nconst wistia = new Wistia({\n  bearerAuth: process.env[\"WISTIA_BEARER_AUTH\"] ?? \"\",\n});\n\nasync function run() {\n  const result = await wistia.account.getBrandKitColors();\n\n  console.log(result);\n}\n\nrun();"
            }
          ]
        }
      }
    }
  },
  "components": {
    "securitySchemes": {
      "BearerAuth": {
        "type": "http",
        "scheme": "bearer"
      }
    }
  },
  "x-readme": {
    "samples-languages": [
      "javascript",
      "shell",
      "node",
      "python",
      "ruby"
    ]
  }
}
````