修改已绑定的 Channel 配对记录的 Identity 或 Template。
Channel 配对目前为 Beta 功能,接口定义、响应结构和行为可能调整,请关注文档更新。
POST /api/v1/forward/channel_pairings/{pairing_id}
修改已绑定(active)记录的 Identity 或 Template。未绑定记录请使用完成配对。
请求参数
使用 Authorization: Bearer <PAT 或 SAT> 和 Content-Type: application/json。路径参数 pairing_id 为配对记录的 id。
| 请求体参数 | 类型 | 说明 |
|---|---|---|
identity_id | string | 新的 Identity ID。 |
template_id | string | 新的 Template ID。 |
null。Channel 和配对范围不可修改。scope_display_name 由渠道消息提供,不支持手动修改。
示例请求
响应
成功返回 HTTP 200 OK,响应为更新后的配对对象,结构与获取配对一致,status 仍为 active。
绑定发生变化后,新消息使用新的执行配置,已有会话不再继续复用。重复提交相同值不会再次变更绑定。
常见错误
| HTTP | 说明 |
|---|---|
| 400 | 未提供可更新字段,或参数值不合法。 |
| 401 | 凭证无效或已过期。 |
| 404 | 已绑定记录、Identity 或 Template 不存在或无权访问。 |
| 409 | 配对状态冲突,或新的 Identity 已停用。 |

