更新 Forward Session 的标题或 metadata。
HTTP 200 OK
请求头
| Header | 是否必填 | 说明 |
|---|---|---|
| Authorization | 是 | Bearer <PAT> |
| Content-Type | 是 | application/json |
| Idempotency-Key | 否 | 有副作用请求可选的幂等键。 |
路径参数
| 参数 | 类型 | 是否必填 | 说明 |
|---|---|---|---|
session_id | string | 是 | Session ID。 |
请求体参数
| 参数 | 类型 | 是否必填 | 说明 |
|---|---|---|---|
title | string | 否 | 新的 Session 标题。 |
metadata | object | 否 | metadata merge patch;传入的 key 覆盖已有 key,未出现的 key 保留。 |
示例请求
示例响应
HTTP 200 OK
响应字段
| 字段 | 类型 | 说明 |
|---|---|---|
| 返回值 | object | 更新后的 Session 对象。 |
错误
| HTTP | Type | Code | 触发条件 |
|---|---|---|---|
| 400 | invalid_request_error | invalid_request | 更新请求体不合法。 |
| 404 | not_found_error | session_not_found | Session 不存在。 |
| 409 | conflict_error | session_archived | Session 已归档。 |
| 401 | authentication_error | TOKEN_INVALID | PAT 缺失、无效或格式错误。 |
备注
config、resources和incremental_streaming_enabled是创建时配置,不能通过本接口修改。