WIwistia
Account

Update Brand Preload

Changed on

Persists the account's default page logo (by Bakery hashed_id) and default player color. Both fields are optional independently — omit a field to leave that account setting untouched. Passing an empty string for selected_logo_hashed_id clears the logo.

Requires the OAuth contact to be an owner or manager of the account (or a Wistia admin) — mirrors the auth check on the underlying updateWtwBrandKitAccountSettings GraphQL mutation.

An expiring access token created with the all:delegate_to_contact_permissions scope and an account authorization granting the manage-brand-preload permission can also be used.

Deliberately narrower than the mutation: this endpoint does not create/update BrandKits or set body font family. Glass's onboarding customize step writes only these two fields; broader brand-kit editing continues to happen through the WTW web UI + GraphQL.

Requires api token with one of the following permissions

(any scope allowed)
put/brand_preload

Request

  • Base URL
    https://api.wistia.com/modern
  • URL
    https://api.wistia.com/modern/brand_preload
  • Auth
    HTTP bearer

Headers

X-Wistia-API-Versionstring required

Request body

selected_player_colorstring

Hex color string (e.g. "#3366FF") for the account's default player color — 6 hex digits, with or without the leading #. Omit or send an empty string to leave the current color untouched (there is no clear operation — color always has a value). Malformed values are rejected at the API boundary; without this check, the model's sanitize step would return nil and silently reset the account color to the global default.

selected_logo_hashed_idstring

Bakery hashed_id of an uploaded logo image, which will become the account's default page logo. Omit to leave the current logo untouched. Pass an empty string to clear the logo.

Response

Successful response — returns the same shape as GET /brand_preload

has_brand_kitsboolean required

True iff the account has one or more configured brand kits. Glass uses this to skip the onboarding preload step for accounts that already have a brand kit set up.

Changes