# Channels

## Delete Channel

<mark style="color:red;">`DELETE`</mark> `https://api.clearfeed.app/v1/rest/channels/:id`

#### Path Parameters

| Name                                 | Type   | Description                                                                                                                                                                                                                                                                                                  |
| ------------------------------------ | ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| id<mark style="color:red;">\*</mark> | string | Slack Channel ID of the channel that needs to be deleted. See [conversations.list](https://docs.slack.dev/reference/methods/conversations.list/) Slack API or use the Channel IDs available from [#get-collections](https://docs.clearfeed.ai/api/reference/collections#get-collections "mention") API call. |

{% tabs %}
{% tab title="200 Deletion is successful" %}

{% endtab %}

{% tab title="403: Forbidden Permission denied" %}

{% endtab %}
{% endtabs %}

## Move Channel To Another Collection

<mark style="color:purple;">`PATCH`</mark> `https://api.clearfeed.app/v1/rest/channels/:id`

#### Path Parameters

| Name                                 | Type   | Description                                                                                                                                                                                                                                                                                                |
| ------------------------------------ | ------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| id<mark style="color:red;">\*</mark> | string | Slack Channel ID of the channel that needs to be moved. See [conversations.list](https://docs.slack.dev/reference/methods/conversations.list/) Slack API or use the Channel IDs available from [#get-collections](https://docs.clearfeed.ai/api/reference/collections#get-collections "mention") API call. |

#### Request Body

| Name                                             | Type | Description                                                                                                                                                                                                                                               |
| ------------------------------------------------ | ---- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| collection\_id<mark style="color:red;">\*</mark> | int  | <p>ID of the collection the channel is to be moved in. </p><p></p><p><strong>Warning:</strong> Use ID returned by <a data-mention href="../collections#get-collections">#get-collections</a>API call and not IDs referenced in the ClearFeed Web App.</p> |

{% tabs %}
{% tab title="200 Channel movement is successful" %}

{% endtab %}

{% tab title="403: Forbidden Permission denied" %}

{% endtab %}
{% endtabs %}