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

# 删除 Channel

> 删除指定 Channel。

`DELETE /api/v1/forward/channels/{channel_id}`

删除不再使用的 Channel。

## 请求头

| Header        | 是否必填 | 说明             |
| ------------- | ---- | -------------- |
| Authorization | 是    | `Bearer <PAT>` |

## 路径参数

| 参数          | 类型     | 是否必填 | 说明                                |
| ----------- | ------ | ---- | --------------------------------- |
| channel\_id | string | 是    | Channel ID，与 Channel 对象的 `id` 相同。 |

## 示例请求

```bash theme={null}
curl -s -X DELETE 'https://api.qoder.com/api/v1/forward/channels/channel_019eabc123' \
  -H "Authorization: Bearer $QODER_PAT"
```

## 示例响应

**HTTP 200 OK**

```json theme={null}
{
  "id": "channel_019eabc123",
  "deleted": true
}
```

## 响应字段

| 字段      | 类型      | 说明                   |
| ------- | ------- | -------------------- |
| id      | string  | 被删除的 Channel ID。     |
| deleted | boolean | 是否删除成功，成功时恒为 `true`。 |

## 删除规则

* 删除成功后，该 Channel 不再处理新的上行消息，也不能继续用于扫码绑定或发送渠道回复。
* 删除是不可恢复操作；如果只是临时停止处理上行消息，应使用 Update Channel 设置 `enabled=false`。

## 错误

| HTTP | Type                   | Code | 触发条件                  |
| ---- | ---------------------- | ---- | --------------------- |
| 401  | `authentication_error` | -    | PAT 无效、过期或缺失。         |
| 404  | `not_found_error`      | -    | Channel 不存在或当前调用方不可见。 |
| 502  | `api_error`            | -    | Channel 删除失败。         |

## 相关

<CardGroup cols={2}>
  <Card title="获取 Channel" icon="file-lines" href="/cloud-agents/api/forward/channels/get" />

  <Card title="更新 Channel" icon="pencil" href="/cloud-agents/api/forward/channels/update" />
</CardGroup>