---
title: "Delete Brand"
method: DELETE
path: "/brands/{brandId}"
tags: ["Brands"]
---

# Delete Brand

`DELETE /brands/{brandId}`

## Request

- Base URL: `https://api.wistia.com/modern`
- URL: `https://api.wistia.com/modern/brands/{brandId}`
- Auth: HTTP bearer

Deletes a brand. Anything the brand was applied to falls back to the
account-level default brand, unless `sync_to_customizations` is set, in
which case the brand's values are written into each item's own
customizations first so they keep their current look.

The account-level default brand (`is_default: true`) can't be deleted.

## Requires api token with one of the following permissions
```
All data
```

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 and an
authorization granting the `destroy` permission on this brand can also be
used.

## Path parameters

- `brandId` string, required

## Query parameters

- `sync_to_customizations` boolean

## Headers

- `X-Wistia-API-Version` string, required

## Response `200`

Brand deleted successfully

- object: A brand is a saved set of branding options — colors, fonts, logos, and layout — that can be applied to media, folders, and channels.
  - `id` string: A unique alphanumeric identifier for this brand.
  - `name` string: The brand's display name.
  - `is_default` boolean: Whether this brand is the account-level default, applied to content that has no more specific brand.
  - `created` string, date-time: The date the brand was originally created.
  - `updated` string, date-time: The date the brand was last updated.
  - `primary_color` union: The primary brand color, used for primary buttons and the player playbar. Either a hex color string or a gradient represented as an array of [hexColor, percentage] tuples. Null when unset.
    - string
    - array[]
      - unknown[]
        - unknown
  - `page_background_color` union: The brand color used for page backgrounds. Either a hex color string or a gradient represented as an array of [hexColor, percentage] tuples. Null when unset.
    - string
    - array[]
      - unknown[]
        - unknown
  - `body_font_family` string, nullable: The brand font family for body text. Null when unset.
  - `headline_font_family` string, nullable: The brand font family for headlines. Null when unset.
  - `button_font_family` string, nullable: The brand font family for buttons. Null when unset.
  - `border_radius` integer, nullable: The border radius in pixels for rounded corners. Null when unset.
  - `contrast_icons` 'enabled' | 'disabled' | 'unset' | 'null', nullable: Controls whether the player icon color is always white or uses an accessible contrast color when necessary.
  - `opaque_controls` 'enabled' | 'disabled' | 'unset' | 'null', nullable: Controls the opacity of the video player control bar and big play button.
  - `page_logo` object, nullable: The brand logo used for pages. Null when unset.
    - `url` string: The Wistia delivery URL of the logo image, e.g. `https://embed-ssl.wistia.com/deliveries/abc123def456.png`. When writing, this must reference an image already in the account; the API cannot upload one.
    - `dimensions` object, nullable
      - `width` integer
      - `height` integer
    - `size` number, nullable: The size multiplier of the logo.
  - `player_logo` object, nullable: The brand logo used for the player. Null when unset.
    - `url` string: The Wistia delivery URL of the logo image, e.g. `https://embed-ssl.wistia.com/deliveries/abc123def456.png`. When writing, this must reference an image already in the account; the API cannot upload one.
    - `dimensions` object, nullable
      - `width` integer
      - `height` integer
    - `size` number, nullable: The size multiplier of the logo.
  - `cursor` string, nullable: A cursor for stable pagination based on current `sort_by` order. You can pass this to `cursor[before]` or `cursor[after]` as a parameter to fetch the records before or after this record in the same sort order. This is only populated if records were fetched with `cursor[enabled]`, or `cursor[before]` or `cursor[after]`.

## Other responses

- `400`: Bad request
- `401`: Unauthorized, invalid or missing token
- `403`: Forbidden, token is valid but account does not have access to feature
- `404`: Resource not found
- `500`: Internal server error

## Changes

- **2026-11-03** `b86cb2a7b420`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/wistia/apis/data-api/changes/brands/:brandId/delete.md)

---

[API](https://skmtc.dev/wistia/apis/data-api.md) - [All operations](https://skmtc.dev/wistia/apis/data-api/llms.txt) - [OpenAPI document](https://skmtc.dev/wistia/apis/data-api/revisions/b86cb2a7b420?raw)