---
source_url: https://www.pubnub.com/docs/chat/kotlin-chat-sdk/build/features/channels/delete
title: Delete channels
updated_at: 2026-06-15T12:11:30.454Z
---

> Documentation Index
> For a curated overview of PubNub documentation, see: https://www.pubnub.com/docs/llms.txt
> For the full list of all documentation pages, see: https://www.pubnub.com/docs/llms-full.txt


# Delete channels

Delete a channel permanently with `delete()` or `deleteChannel()`.

Call `delete()` on a `Channel` object or `deleteChannel()` on the `Chat` object with the channel ID.

:::note Requires App Context
Enable [App Context](https://youtu.be/9UEoSlngpYI) for your keyset in the [Admin Portal](https://admin.pubnub.com/).
:::

### Method signature

These methods take the following parameters:

* delete() 1channel.delete(): PNFuture<Unit>
* deleteChannel() 1chat.deleteChannel(id: String): PNFuture<Unit>

#### Input

| Parameter | Required in delete() | Required in deleteChannel() | Description |
| --- | --- | --- | --- |
| id | String | Optional |  | No | Yes | Unique channel identifier. |

#### Output

| Method | Description |
| --- | --- |
| `delete()`Type: `PNFuture<Unit>` | Returns when the channel is successfully deleted. |
| `deleteChannel()`Type: `PNFuture<Unit>` | Returns when the channel is successfully deleted. |

### Sample code

Delete the `support` channel.

* delete() 1// reference the "channel" object and invoke the "delete()" method2chat.getChannel("support").async { result ->3 result.onSuccess { channel ->4 if (channel != null) {5 channel.delete().async { deleteResult ->6 deleteResult.onSuccess {7 // handle success8 }.onFailure {9 // handle failure10 }11 }12 }13 }.onFailure {14 // handle failure15 }16}
* deleteChannel() 1// reference the "chat" object and invoke the "deleteChannel()" method2chat.deleteChannel("support").async { result ->3 result.onSuccess {4 // handle success5 }.onFailure {6 // handle failure7 }8}