> ## Documentation Index
> Fetch the complete documentation index at: https://mintlify.com/open-webui/open-webui/llms.txt
> Use this file to discover all available pages before exploring further.

# Delete Channel

> Delete a channel and all its messages

Permanently deletes a channel and all associated messages, reactions, and member data. This action cannot be undone.

## Authentication

Requires a valid user session. User must be the channel creator or an admin.

## Path Parameters

<ParamField path="id" type="string" required>
  The unique identifier of the channel to delete
</ParamField>

## Response

Returns a boolean indicating success.

<ResponseField name="success" type="boolean" required>
  `true` if the channel was deleted successfully
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl -X DELETE "https://your-domain.com/api/channels/ch_abc123/delete" \
    -H "Authorization: Bearer YOUR_TOKEN" \
    -H "Content-Type: application/json"
  ```

  ```python Python theme={null}
  import requests

  response = requests.delete(
      "https://your-domain.com/api/channels/ch_abc123/delete",
      headers={"Authorization": "Bearer YOUR_TOKEN"}
  )

  if response.json():
      print("Channel deleted successfully")
  ```

  ```javascript JavaScript theme={null}
  const response = await fetch(
    'https://your-domain.com/api/channels/ch_abc123/delete',
    {
      method: 'DELETE',
      headers: {
        'Authorization': 'Bearer YOUR_TOKEN',
        'Content-Type': 'application/json'
      }
    }
  );

  const result = await response.json();
  if (result) {
    console.log('Channel deleted successfully');
  }
  ```
</RequestExample>

<ResponseExample>
  ```json 200 OK theme={null}
  true
  ```

  ```json 404 Not Found theme={null}
  {
    "detail": "Not found"
  }
  ```

  ```json 403 Forbidden theme={null}
  {
    "detail": "ERROR"
  }
  ```

  ```json 400 Bad Request theme={null}
  {
    "detail": "ERROR"
  }
  ```
</ResponseExample>

## Notes

* Only the channel creator or admins can delete channels
* This action permanently deletes:
  * The channel itself
  * All messages in the channel
  * All message reactions
  * All member associations
  * All webhooks associated with the channel
  * All file associations
* This operation cannot be undone
* Members will be removed from the channel's socket room automatically