cURL
Authorizations
string
header
required
DashScope API Key
Path Parameters
string
required
Body
application/jsonstring
会话标题
object
业务自定义键值。整体替换元数据;省略保持原值,null 不执行更新。嵌套与数量限制同创建时
object
会话运行时注入的环境变量,字符串键值对,沙箱代码中可直接按名读取。整体替换;空对象清空,省略保持原值
string[]
整体替换 Vault 绑定;空数组清空,省略保持原值。同一会话绑定多个 Vault 时,不同 Vault 之间的 secret_name 不能重复,也不要使用前缀相同的名称(例如 API_KEY 与 API_KEY_V2),否则更新会话返回 400 invalid_parameter(Invalid request)
object
会话级 Agent 配置 patch,只能携带 system / tools / mcp_servers / skills 四个覆盖字段,携带其他字段(如 type / id / version / model)返回 invalid_parameter。子字段语义:省略保留已有覆盖;null 删除该字段覆盖并重新继承智能体源配置;空数组明确覆盖为空;空字符串(仅 system)明确使用空提示词。更新仅影响本会话快照,不改动智能体本身
object[]
整体替换会话级 MCP 请求头;空数组清空,省略保持原值,null 非法