API Reference
Wistia Learning CenterWistia

Update Appearance Customizations

put
https://api.wistia.com/modern/medias//customizations/appearance

Applies a partial update to a video's appearance customizations. Only the
fields supplied are changed; sending a field as null deletes it (reverting to
the default).

Requires api token with one of the following permissions

Read, update & delete anything
Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requestsā€¦
LoadingLoadingā€¦
Path Params
string
required

The hashed ID of the video to be customized.

Body Params

Player visual identity & branding for a video. Every field is optional; only
the fields you send are changed (partial update). Send a field as null to
reset it to its default.

string

Base color of the player as a hexadecimal RGB string (no leading '#').

playerColorGradient
object

Optional gradient applied to the player color.

integer

Corner radius of the player in pixels. 0 disables rounding.

boolean

If true, player controls render on an opaque background.

boolean

If true, control icons use a higher-contrast treatment.

boolean

If false, Wistia branding is hidden on the player.

boolean

If true, your customer logo is shown on the player.

string

URL of the customer logo image to display on the player.

string

URL the customer logo links to when clicked.

string

Placement of the customer logo on the player (e.g. top-right).

integer

Size of the customer logo as a percentage of the player.

Headers
string
required
Defaults to 2026-07
Responses

Updated 29 days ago

Did this page help you?
Language
Credentials
Bearer
LoadingLoadingā€¦
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated 29 days ago

Did this page help you?