---
title: "删除 Channel"
method: DELETE
path: "/agent/forward/v0/channels/{channelId}"
tags: ["Channel"]
---

# 删除 Channel

`DELETE /agent/forward/v0/channels/{channelId}`

## Request

- Base URL: `https://agent-api.bigmodel.cn/api`
- URL: `https://agent-api.bigmodel.cn/api/agent/forward/v0/channels/{channelId}`
- Auth: HTTP bearer

软删除并归档 Channel，停止连接、后续消息处理和发送，清除渠道凭据。删除是解除接入，不是暂停；不提供恢复此 Channel 的操作。

## Path parameters

- `channelId` string, required

## Headers

- `zai-version` '2026-05-26', required
- `zai-beta` string, required

## Response `200`

请求成功。

- ForwardChannelDeleted
  - `id` string, required
  - `deleted` true, required

## Other responses

- `404`: 资源不存在、已删除或不属于当前账号。
- `429`: 账号或全局请求频率超限。

## Changes

- **2026-11-05** `f2be7c0fcbb9`: 1 warning, 1 info
  - the optional response header `Retry-After` removed for the status `429`
  - added the non-success response with the status `404`
- **2026-11-03** `7fd61aa7f811`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/bigmodel/apis/zhipu-ai-api/changes/agent/forward/v0/channels/:channelId/delete.md)

---

[API](https://skmtc.dev/bigmodel/apis/zhipu-ai-api.md) - [All operations](https://skmtc.dev/bigmodel/apis/zhipu-ai-api/llms.txt) - [OpenAPI document](https://skmtc.dev/bigmodel/apis/zhipu-ai-api/revisions/f2be7c0fcbb9?raw)