POST /api/v1/forward/channels/{channel_id}
使用 merge-patch 语义，未出现字段保持不变。
请求头
| Header | 是否必填 | 说明 |
|---|---|---|
| Authorization | 是 | Bearer <PAT 或 SAT> |
| Content-Type | 是 | application/json |
| Idempotency-Key | 否 | 有副作用请求可选的幂等键。 |
路径参数
| 参数 | 类型 | 是否必填 | 说明 |
|---|---|---|---|
| channel_id | string | 是 | Channel ID。 |
请求体参数
| 参数 | 类型 | 是否必填 | 说明 |
|---|---|---|---|
| name | string | 否 | Channel 展示名。 |
| identity_id | string | 否 | fixed 模式下新的 Forward Identity ID。 |
| template_id | string | 否 | fixed 模式下新的 Forward Template ID。 |
| enabled | boolean | 否 | 人工启停开关。 |
| channel_config.credentials | object | 否 | 更新渠道凭据，用于凭据轮换。 |
| channel_config.response_options | object | 否 | 回复内容可见性配置。 |
示例请求
示例响应
HTTP 200 OK
响应字段
| 字段 | 类型 | 说明 |
|---|---|---|
| 返回值 | object | 更新后的 Channel 对象。 |
错误码
| HTTP | Type | 触发条件 |
|---|---|---|
| 400 | invalid_request_error | 请求体不合法。 |
| 401 | authentication_error | PAT 或 SAT 无效或已过期。 |
| 404 | not_found_error | Channel 不存在。 |
| 404 | not_found_error | 新的 Template 不存在。 |
| 404 | not_found_error | 新的 Identity 不存在。 |
| 409 | conflict_error | 新的 Identity 已停用。 |
注意事项
identity_resolution.mode创建后不可更新；需要切换模式时必须删除并重建 Channel。pairing模式不允许更新identity_id或template_id，二者由 Pairing API 按消息范围绑定。id、type和channel_type不允许更新。binding_status由系统维护。enabled=true只打开人工开关，不改变binding_status。fixed模式更新identity_id或template_id后，已有会话关系可能停止复用，新消息按新绑定创建会话。