---
title: "Changes to DELETE /channels/{channel_id}"
method: DELETE
path: "/channels/{channel_id}"
---

# Changes to DELETE /channels/{channel_id}

`DELETE /channels/{channel_id}`

> Every recorded change to this endpoint, newest first.

## Timeline

Changed in 3 of 58 revisions.

- **2026-06-05** `693bf1f99bba` — 4 breaking, 2 warning
- **2026-04-17** `e5468cac9be0` — 2 breaking, 3 info
- **2026-02-04** `e200830e509a` — 43 info

## Changes

- **2026-06-05** `693bf1f99bba` — 4 breaking, 2 warning
  - added `subschema #1: CRIMSON, subschema #2: BERRY, subschema #3: SKY, subschema #4: TEAL, subschema #5: FOREST, subschema #6: BUBBLE_GUM, subschema #7: VIOLET, subschema #8: COBALT, subschema #9: CLOVER, subschema #10: LEMON, subschema #11: WHITE, subschema #12: BLACK` to the `oneOf[#/components/schemas/PrivateChannelResponse]/recipients/items/collectibles/oneOf[#/components/schemas/UserCollectiblesResponse]/nameplate/oneOf[#/components/schemas/UserNameplateResponse]/palette` response property `oneOf` list for the response status `200`
  - added `subschema #1: CRIMSON, subschema #2: BERRY, subschema #3: SKY, subschema #4: TEAL, subschema #5: FOREST, subschema #6: BUBBLE_GUM, subschema #7: VIOLET, subschema #8: COBALT, subschema #9: CLOVER, subschema #10: LEMON, subschema #11: WHITE, subschema #12: BLACK` to the `oneOf[#/components/schemas/PrivateGroupChannelResponse]/recipients/items/collectibles/oneOf[#/components/schemas/UserCollectiblesResponse]/nameplate/oneOf[#/components/schemas/UserNameplateResponse]/palette` response property `oneOf` list for the response status `200`
  - added `subschema #1: CRIMSON, subschema #2: BERRY, subschema #3: SKY, subschema #4: TEAL, subschema #5: FOREST, subschema #6: BUBBLE_GUM, subschema #7: VIOLET, subschema #8: COBALT, subschema #9: CLOVER, subschema #10: LEMON, subschema #11: WHITE, subschema #12: BLACK` to the `oneOf[#/components/schemas/ThreadResponse]/member/member/collectibles/oneOf[#/components/schemas/UserCollectiblesResponse]/nameplate/oneOf[#/components/schemas/UserNameplateResponse]/palette` response property `oneOf` list for the response status `200`
  - added `subschema #1: CRIMSON, subschema #2: BERRY, subschema #3: SKY, subschema #4: TEAL, subschema #5: FOREST, subschema #6: BUBBLE_GUM, subschema #7: VIOLET, subschema #8: COBALT, subschema #9: CLOVER, subschema #10: LEMON, subschema #11: WHITE, subschema #12: BLACK` to the `oneOf[#/components/schemas/ThreadResponse]/member/member/user/collectibles/oneOf[#/components/schemas/UserCollectiblesResponse]/nameplate/oneOf[#/components/schemas/UserNameplateResponse]/palette` response property `oneOf` list for the response status `200`
  - removed the optional property `oneOf[#/components/schemas/GuildChannelResponse]/hd_streaming_buyer_id` from the response with the `200` status
  - removed the optional property `oneOf[#/components/schemas/GuildChannelResponse]/hd_streaming_until` from the response with the `200` status
- **2026-04-17** `e5468cac9be0` — 2 breaking, 3 info
  - added `subschema #1: DEFAULT, subschema #2: LIST, subschema #3: GRID` to the `oneOf[#/components/schemas/GuildChannelResponse]/default_forum_layout` response property `oneOf` list for the response status `200`
  - the `oneOf[#/components/schemas/GuildChannelResponse]/default_forum_layout` response's property type/format changed from ``/`` to `integer`/`int32` for status `200`
  - the response property `oneOf[#/components/schemas/GuildChannelResponse]/default_reaction_emoji/oneOf[#/components/schemas/DefaultReactionEmojiResponse]/emoji_id` became required for the status `200`
  - the response property `oneOf[#/components/schemas/GuildChannelResponse]/default_reaction_emoji/oneOf[#/components/schemas/DefaultReactionEmojiResponse]/emoji_name` became required for the status `200`
  - removed `#/components/schemas/ForumLayout, subschema #1` from the `oneOf[#/components/schemas/GuildChannelResponse]/default_forum_layout` response property `oneOf` list for the response status `200`
- **2026-02-04** `e200830e509a` — 43 info
  - the response property `oneOf[#/components/schemas/GuildChannelResponse]/available_tags/items/emoji_id` became required for the status `200`
  - the response property `oneOf[#/components/schemas/GuildChannelResponse]/available_tags/items/emoji_name` became required for the status `200`
  - the response property `oneOf[#/components/schemas/PrivateChannelResponse]/recipients/items/avatar` became required for the status `200`
  - the response property `oneOf[#/components/schemas/PrivateChannelResponse]/recipients/items/avatar_decoration_data/oneOf[#/components/schemas/UserAvatarDecorationResponse]/sku_id` became required for the status `200`
  - the response property `oneOf[#/components/schemas/PrivateChannelResponse]/recipients/items/collectibles/oneOf[#/components/schemas/UserCollectiblesResponse]/nameplate` became required for the status `200`
  - the response property `oneOf[#/components/schemas/PrivateChannelResponse]/recipients/items/collectibles/oneOf[#/components/schemas/UserCollectiblesResponse]/nameplate/oneOf[#/components/schemas/UserNameplateResponse]/sku_id` became required for the status `200`
  - the response property `oneOf[#/components/schemas/PrivateChannelResponse]/recipients/items/global_name` became required for the status `200`
  - the response property `oneOf[#/components/schemas/PrivateChannelResponse]/recipients/items/primary_guild` became required for the status `200`
  - the response property `oneOf[#/components/schemas/PrivateChannelResponse]/recipients/items/primary_guild/oneOf[#/components/schemas/UserPrimaryGuildResponse]/badge` became required for the status `200`
  - the response property `oneOf[#/components/schemas/PrivateChannelResponse]/recipients/items/primary_guild/oneOf[#/components/schemas/UserPrimaryGuildResponse]/identity_enabled` became required for the status `200`
  - the response property `oneOf[#/components/schemas/PrivateChannelResponse]/recipients/items/primary_guild/oneOf[#/components/schemas/UserPrimaryGuildResponse]/identity_guild_id` became required for the status `200`
  - the response property `oneOf[#/components/schemas/PrivateChannelResponse]/recipients/items/primary_guild/oneOf[#/components/schemas/UserPrimaryGuildResponse]/tag` became required for the status `200`
  - the response property `oneOf[#/components/schemas/PrivateGroupChannelResponse]/icon` became required for the status `200`
  - the response property `oneOf[#/components/schemas/PrivateGroupChannelResponse]/name` became required for the status `200`
  - the response property `oneOf[#/components/schemas/PrivateGroupChannelResponse]/recipients/items/avatar` became required for the status `200`
  - the response property `oneOf[#/components/schemas/PrivateGroupChannelResponse]/recipients/items/avatar_decoration_data/oneOf[#/components/schemas/UserAvatarDecorationResponse]/sku_id` became required for the status `200`
  - the response property `oneOf[#/components/schemas/PrivateGroupChannelResponse]/recipients/items/collectibles/oneOf[#/components/schemas/UserCollectiblesResponse]/nameplate` became required for the status `200`
  - the response property `oneOf[#/components/schemas/PrivateGroupChannelResponse]/recipients/items/collectibles/oneOf[#/components/schemas/UserCollectiblesResponse]/nameplate/oneOf[#/components/schemas/UserNameplateResponse]/sku_id` became required for the status `200`
  - the response property `oneOf[#/components/schemas/PrivateGroupChannelResponse]/recipients/items/global_name` became required for the status `200`
  - the response property `oneOf[#/components/schemas/PrivateGroupChannelResponse]/recipients/items/primary_guild` became required for the status `200`
  - the response property `oneOf[#/components/schemas/PrivateGroupChannelResponse]/recipients/items/primary_guild/oneOf[#/components/schemas/UserPrimaryGuildResponse]/badge` became required for the status `200`
  - the response property `oneOf[#/components/schemas/PrivateGroupChannelResponse]/recipients/items/primary_guild/oneOf[#/components/schemas/UserPrimaryGuildResponse]/identity_enabled` became required for the status `200`
  - the response property `oneOf[#/components/schemas/PrivateGroupChannelResponse]/recipients/items/primary_guild/oneOf[#/components/schemas/UserPrimaryGuildResponse]/identity_guild_id` became required for the status `200`
  - the response property `oneOf[#/components/schemas/PrivateGroupChannelResponse]/recipients/items/primary_guild/oneOf[#/components/schemas/UserPrimaryGuildResponse]/tag` became required for the status `200`
  - the response property `oneOf[#/components/schemas/ThreadResponse]/member/member/avatar` became required for the status `200`
  - the response property `oneOf[#/components/schemas/ThreadResponse]/member/member/avatar_decoration_data/oneOf[#/components/schemas/UserAvatarDecorationResponse]/sku_id` became required for the status `200`
  - the response property `oneOf[#/components/schemas/ThreadResponse]/member/member/banner` became required for the status `200`
  - the response property `oneOf[#/components/schemas/ThreadResponse]/member/member/collectibles/oneOf[#/components/schemas/UserCollectiblesResponse]/nameplate` became required for the status `200`
  - the response property `oneOf[#/components/schemas/ThreadResponse]/member/member/collectibles/oneOf[#/components/schemas/UserCollectiblesResponse]/nameplate/oneOf[#/components/schemas/UserNameplateResponse]/sku_id` became required for the status `200`
  - the response property `oneOf[#/components/schemas/ThreadResponse]/member/member/communication_disabled_until` became required for the status `200`
  - the response property `oneOf[#/components/schemas/ThreadResponse]/member/member/nick` became required for the status `200`
  - the response property `oneOf[#/components/schemas/ThreadResponse]/member/member/premium_since` became required for the status `200`
  - the response property `oneOf[#/components/schemas/ThreadResponse]/member/member/user/avatar` became required for the status `200`
  - the response property `oneOf[#/components/schemas/ThreadResponse]/member/member/user/avatar_decoration_data/oneOf[#/components/schemas/UserAvatarDecorationResponse]/sku_id` became required for the status `200`
  - the response property `oneOf[#/components/schemas/ThreadResponse]/member/member/user/collectibles/oneOf[#/components/schemas/UserCollectiblesResponse]/nameplate` became required for the status `200`
  - the response property `oneOf[#/components/schemas/ThreadResponse]/member/member/user/collectibles/oneOf[#/components/schemas/UserCollectiblesResponse]/nameplate/oneOf[#/components/schemas/UserNameplateResponse]/sku_id` became required for the status `200`
  - the response property `oneOf[#/components/schemas/ThreadResponse]/member/member/user/global_name` became required for the status `200`
  - the response property `oneOf[#/components/schemas/ThreadResponse]/member/member/user/primary_guild` became required for the status `200`
  - the response property `oneOf[#/components/schemas/ThreadResponse]/member/member/user/primary_guild/oneOf[#/components/schemas/UserPrimaryGuildResponse]/badge` became required for the status `200`
  - the response property `oneOf[#/components/schemas/ThreadResponse]/member/member/user/primary_guild/oneOf[#/components/schemas/UserPrimaryGuildResponse]/identity_enabled` became required for the status `200`
  - …3 more

---

[Operation](https://skmtc.dev/discord/apis/discord-http-api-preview/docs/channels/:channel_id/delete.md) · [API](https://skmtc.dev/discord/apis/discord-http-api-preview.md) · [Page](https://skmtc.dev/discord/apis/discord-http-api-preview/changes/channels/:channel_id/delete)