修改会话的 title、metadata 与 environment_variables。会话更新是唯一会触发 session.updated 事件的操作。
前提
已完成 Endpoint 与鉴权配置，详见API 总览与认证。
接口
POST /sessions/{session_id}
支持修改 title、metadata 与 environment_variables。会话更新是唯一会触发session.updated事件的操作。
请求体
| 字段 | 必填 | 类型 | 说明 |
|---|---|---|---|
title | 否 | string | 会话标题 |
metadata | 否 | object | 业务自定义键值 |
environment_variables | 否 | object | 会话运行时注入的环境变量，字符串键值对，沙箱代码中可直接按名读取 |
请求示例
响应示例
仅返回更新后的字段、updated_at 与 request_id。
响应字段
| 字段 | 类型 | 说明 |
|---|---|---|
id | string | 会话 ID |
type | string | 固定为 session |
status | string | 当前会话状态（更新不改变状态） |
title / metadata | string / object | 请求体覆盖后的新值 |
updated_at | string | 最近更新时间，ISO 8601 |
request_id | string | 本次请求的唯一标识 |
environment_variables | object | 会话运行时注入的环境变量，字符串键值对，沙箱代码中可直接按名读取 |