> ## 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 会话范围与其 Identity 的配对关系。

`DELETE /api/v1/forward/channel_pairings/{pairing_id}`

## 请求头

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

## 路径参数

| 参数           | 类型     | 是否必填 | 说明                  |
| ------------ | ------ | ---- | ------------------- |
| `pairing_id` | string | 是    | 配对接口返回的 Pairing ID。 |

## 示例请求

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

## 示例响应

**HTTP 200 OK**

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

## 响应字段

| 字段        | 类型      | 说明             |
| --------- | ------- | -------------- |
| `id`      | string  | Pairing ID。    |
| `deleted` | boolean | 成功解除时为 `true`。 |

## 错误码

| HTTP | Type                   | 触发条件        |
| ---- | ---------------------- | ----------- |
| 401  | `authentication_error` | PAT 无效或已过期。 |

## 注意事项

* 即使 Pairing 不存在或已被移除，也会返回 `deleted=true`。
* 解除配对后，该会话范围内的下一条消息将触发新的 Pairing Code。

## 相关

<CardGroup cols={2}>
  <Card title="配对 Channel" icon="link" href="/zh/cloud-agents/api/forward/channels/pair-channel" />

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