解除 Channel 会话范围与其 Identity 的配对关系。
DELETE /api/v1/forward/channel_pairings/{pairing_id}
请求头
| Header | 是否必填 | 说明 |
|---|---|---|
Authorization | 是 | Bearer <PAT 或 SAT> |
路径参数
| 参数 | 类型 | 是否必填 | 说明 |
|---|---|---|---|
pairing_id | string | 是 | 列出 Channel 配对、获取配对或完成配对返回的 id。 |
示例请求
示例响应
HTTP 200 OK
响应字段
| 字段 | 类型 | 说明 |
|---|---|---|
id | string | Pairing ID。 |
deleted | boolean | 成功解除时为 true。 |
HTTP 错误码
| HTTP | Type | 触发条件 |
|---|---|---|
| 400 | invalid_request_error | pairing_id 为空白或含控制字符;查询配对归属时发现 Channel 非 pairing 模式。 |
| 401 | authentication_error | PAT 或 SAT 无效或已过期。 |
| 403 | permission_error | 无调用权限。 |
| 404 | not_found_error | 查询配对归属时,所属 Channel 不存在、已归档或不可访问。 |
| 409 | conflict_error | 绑定被并发修改。 |
注意事项
- 不存在或已解绑的配对返回
200、deleted=true;仍存在的配对须通过访问权限校验。 - 解除后原绑定失效;再次触发渠道配对流程可获取新配对码。

