---
title: "Delete Channel"
method: DELETE
path: "/channels/{channelHashedId}"
tags: ["Channels"]
---

# Delete Channel

`DELETE /channels/{channelHashedId}`

Deletes a channel.

## Path parameters

- `channelHashedId` string, required

## Headers

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

## Response `200`

Channel deleted successful

- object — A Channel lets you take a collection of video (or audio) and embed them on your site, as well as distribute through podcasting.
  - `id` integer, required — The numeric id of the channel.
  - `created` string, date-time, required — The date when the channel was originally created.
  - `description` string, required — The channel's description.
  - `hashed_id` string, required — A unique alphanumeric identifier for this channel.
  - `media_count` integer, required — The number of medias in the channel.
  - `live_stream_event_count` integer — The number of live stream events in the channel.
  - `name` string, required — The display name for the channel
  - `updated` string, date-time, required — The date when the channel was last updated.
  - `auto_publish_enabled` boolean, nullable — Whether episodes are automatically published when added to the channel.
  - `podcast_enabled` boolean, nullable — Whether podcasting is enabled for the channel.
  - `custom_url` string, nullable — The custom URL used when embedding the channel on your own site. Null if no custom URL is set.
  - `podcast_settings` object — Podcast specific settings for the channel. Only present when podcasting is enabled for the channel.
    - `copyright` string, nullable — The channel's copyright information.
    - `episode_format` 'episodic' | 'episodic_with_seasons' | 'serial', nullable — The format for episodes for the podcast channel.
    - `author_name` string, nullable — The name of the author(s) for the channel.
    - `explicit` boolean, nullable — Whether the channel contains explicit content.
    - `owner_name` string, nullable — The name of the owner for the channel.
    - `owner_email` string, nullable — The email of the owner for the channel.
    - `category1` 'arts > books' | 'arts > design' | 'arts > fashion_and_beauty' | 'arts > food' | 'arts > performing_arts' | 'arts > visual_arts' | 'business > careers' | 'business > entrepreneurship' | 'business > investing' | 'business > management' | 'business > marketing' | 'business > non_profit' | 'comedy > comedy_interviews' | 'comedy > improv' | 'comedy > stand_up' | 'education > courses' | 'education > how_to' | 'education > language_learning' | 'education > self_improvement' | 'fiction > comedy_fiction' | 'fiction > drama' | 'fiction > science_fiction' | 'health_and_fitness > alternative_health' | 'health_and_fitness > fitness' | 'health_and_fitness > medicine' | 'health_and_fitness > mental_health' | 'health_and_fitness > nutrition' | 'health_and_fitness > sexuality' | 'kids_and_family > education_for_kids' | 'kids_and_family > parenting' | 'kids_and_family > pets_and_animals' | 'kids_and_family > stories_for_kids' | 'leisure > animation_and_manga' | 'leisure > automotive' | 'leisure > aviation' | 'leisure > crafts' | 'leisure > games' | 'leisure > hobbies' | 'leisure > home_and_garden' | 'leisure > video_games' | 'music > music_commentary' | 'music > music_history' | 'music > music_interviews' | 'news > business_news' | 'news > daily_news' | 'news > entertainment_news' | 'news > news_commentary' | 'news > politics' | 'news > sports_news' | 'news > tech_news' | 'religion_and_spirituality > buddhism' | 'religion_and_spirituality > christianity' | 'religion_and_spirituality > hinduism' | 'religion_and_spirituality > islam' | 'religion_and_spirituality > judaism' | 'religion_and_spirituality > religion' | 'religion_and_spirituality > spirituality' | 'science > astronomy' | 'science > chemistry' | 'science > earth_sciences' | 'science > life_sciences' | 'science > mathematics' | 'science > natural_sciences' | 'science > nature' | 'science > physics' | 'science > social_sciences' | 'society_and_culture > documentary' | 'society_and_culture > personal_journals' | 'society_and_culture > philosophy' | 'society_and_culture > places_and_travel' | 'society_and_culture > relationships' | 'sports > baseball' | 'sports > basketball' | 'sports > cricket' | 'sports > fantasy_sports' | 'sports > football' | 'sports > golf' | 'sports > hockey' | 'sports > rugby' | 'sports > running' | 'sports > soccer' | 'sports > swimming' | 'sports > tennis' | 'sports > volleyball' | 'sports > wilderness' | 'sports > wrestling' | 'tv_and_film > after_shows' | 'tv_and_film > film_history' | 'tv_and_film > film_interviews' | 'tv_and_film > film_reviews' | 'tv_and_film > tv_reviews', nullable — The primary category for the channel.
    - `category2` 'arts > books' | 'arts > design' | 'arts > fashion_and_beauty' | 'arts > food' | 'arts > performing_arts' | 'arts > visual_arts' | 'business > careers' | 'business > entrepreneurship' | 'business > investing' | 'business > management' | 'business > marketing' | 'business > non_profit' | 'comedy > comedy_interviews' | 'comedy > improv' | 'comedy > stand_up' | 'education > courses' | 'education > how_to' | 'education > language_learning' | 'education > self_improvement' | 'fiction > comedy_fiction' | 'fiction > drama' | 'fiction > science_fiction' | 'health_and_fitness > alternative_health' | 'health_and_fitness > fitness' | 'health_and_fitness > medicine' | 'health_and_fitness > mental_health' | 'health_and_fitness > nutrition' | 'health_and_fitness > sexuality' | 'kids_and_family > education_for_kids' | 'kids_and_family > parenting' | 'kids_and_family > pets_and_animals' | 'kids_and_family > stories_for_kids' | 'leisure > animation_and_manga' | 'leisure > automotive' | 'leisure > aviation' | 'leisure > crafts' | 'leisure > games' | 'leisure > hobbies' | 'leisure > home_and_garden' | 'leisure > video_games' | 'music > music_commentary' | 'music > music_history' | 'music > music_interviews' | 'news > business_news' | 'news > daily_news' | 'news > entertainment_news' | 'news > news_commentary' | 'news > politics' | 'news > sports_news' | 'news > tech_news' | 'religion_and_spirituality > buddhism' | 'religion_and_spirituality > christianity' | 'religion_and_spirituality > hinduism' | 'religion_and_spirituality > islam' | 'religion_and_spirituality > judaism' | 'religion_and_spirituality > religion' | 'religion_and_spirituality > spirituality' | 'science > astronomy' | 'science > chemistry' | 'science > earth_sciences' | 'science > life_sciences' | 'science > mathematics' | 'science > natural_sciences' | 'science > nature' | 'science > physics' | 'science > social_sciences' | 'society_and_culture > documentary' | 'society_and_culture > personal_journals' | 'society_and_culture > philosophy' | 'society_and_culture > places_and_travel' | 'society_and_culture > relationships' | 'sports > baseball' | 'sports > basketball' | 'sports > cricket' | 'sports > fantasy_sports' | 'sports > football' | 'sports > golf' | 'sports > hockey' | 'sports > rugby' | 'sports > running' | 'sports > soccer' | 'sports > swimming' | 'sports > tennis' | 'sports > volleyball' | 'sports > wilderness' | 'sports > wrestling' | 'tv_and_film > after_shows' | 'tv_and_film > film_history' | 'tv_and_film > film_interviews' | 'tv_and_film > film_reviews' | 'tv_and_film > tv_reviews', nullable — The secondary category for the channel.
    - `category3` 'arts > books' | 'arts > design' | 'arts > fashion_and_beauty' | 'arts > food' | 'arts > performing_arts' | 'arts > visual_arts' | 'business > careers' | 'business > entrepreneurship' | 'business > investing' | 'business > management' | 'business > marketing' | 'business > non_profit' | 'comedy > comedy_interviews' | 'comedy > improv' | 'comedy > stand_up' | 'education > courses' | 'education > how_to' | 'education > language_learning' | 'education > self_improvement' | 'fiction > comedy_fiction' | 'fiction > drama' | 'fiction > science_fiction' | 'health_and_fitness > alternative_health' | 'health_and_fitness > fitness' | 'health_and_fitness > medicine' | 'health_and_fitness > mental_health' | 'health_and_fitness > nutrition' | 'health_and_fitness > sexuality' | 'kids_and_family > education_for_kids' | 'kids_and_family > parenting' | 'kids_and_family > pets_and_animals' | 'kids_and_family > stories_for_kids' | 'leisure > animation_and_manga' | 'leisure > automotive' | 'leisure > aviation' | 'leisure > crafts' | 'leisure > games' | 'leisure > hobbies' | 'leisure > home_and_garden' | 'leisure > video_games' | 'music > music_commentary' | 'music > music_history' | 'music > music_interviews' | 'news > business_news' | 'news > daily_news' | 'news > entertainment_news' | 'news > news_commentary' | 'news > politics' | 'news > sports_news' | 'news > tech_news' | 'religion_and_spirituality > buddhism' | 'religion_and_spirituality > christianity' | 'religion_and_spirituality > hinduism' | 'religion_and_spirituality > islam' | 'religion_and_spirituality > judaism' | 'religion_and_spirituality > religion' | 'religion_and_spirituality > spirituality' | 'science > astronomy' | 'science > chemistry' | 'science > earth_sciences' | 'science > life_sciences' | 'science > mathematics' | 'science > natural_sciences' | 'science > nature' | 'science > physics' | 'science > social_sciences' | 'society_and_culture > documentary' | 'society_and_culture > personal_journals' | 'society_and_culture > philosophy' | 'society_and_culture > places_and_travel' | 'society_and_culture > relationships' | 'sports > baseball' | 'sports > basketball' | 'sports > cricket' | 'sports > fantasy_sports' | 'sports > football' | 'sports > golf' | 'sports > hockey' | 'sports > rugby' | 'sports > running' | 'sports > soccer' | 'sports > swimming' | 'sports > tennis' | 'sports > volleyball' | 'sports > wilderness' | 'sports > wrestling' | 'tv_and_film > after_shows' | 'tv_and_film > film_history' | 'tv_and_film > film_interviews' | 'tv_and_film > film_reviews' | 'tv_and_film > tv_reviews', nullable — The third category for the channel.
    - `language` 'af' | 'be' | 'bg' | 'ca' | 'cs' | 'da' | 'de-at' | 'de-ch' | 'de-de' | 'de-li' | 'de-lu' | 'de' | 'el' | 'en-au' | 'en-bz' | 'en-ca' | 'en-gb' | 'en-ie' | 'en-jm' | 'en-nz' | 'en-ph' | 'en-tt' | 'en-us' | 'en-za' | 'en-zw' | 'en' | 'es-ar' | 'es-bo' | 'es-cl' | 'es-co' | 'es-cr' | 'es-do' | 'es-ec' | 'es-es' | 'es-gt' | 'es-hn' | 'es-mx' | 'es-ni' | 'es-pa' | 'es-pe' | 'es-pr' | 'es-py' | 'es-sv' | 'es-uy' | 'es-ve' | 'es' | 'et' | 'eu' | 'fi' | 'fo' | 'fr-be' | 'fr-ca' | 'fr-ch' | 'fr-fr' | 'fr-lu' | 'fr-mc' | 'fr' | 'ga' | 'gd' | 'gl' | 'haw' | 'hr' | 'hu' | 'in' | 'is' | 'it-ch' | 'it-it' | 'it' | 'ja' | 'ko' | 'mk' | 'nl-be' | 'nl-nl' | 'nl' | 'no' | 'pl' | 'pt-br' | 'pt-pt' | 'pt' | 'ro-mo' | 'ro-ro' | 'ro' | 'ru-mo' | 'ru-ru' | 'ru' | 'sk' | 'sl' | 'sq' | 'sr' | 'sv-fi' | 'sv-se' | 'sv' | 'tr' | 'uk' | 'zh-cn' | 'zh-tw', nullable — The ISO 639-1 language code for the channel.
  - `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

- `401` — Unauthorized, invalid or missing token
- `403` — Forbidden, token is valid but account does not have access to feature
- `500` — Internal server error

---

[API](https://skmtc.dev/wistia/apis/data-api.md) · [All operations](https://skmtc.dev/wistia/apis/data-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/wistia/data-api/revisions/e40b3678d9d5/schema)