更新会话 API：POST /sessions/{session_id}-大模型服务平台百炼(Model Studio)-阿里云帮助中心

仅支持修改 title 与 metadata。会话更新是唯一会触发 session.updated 事件的操作。

前提

已完成 Endpoint 与鉴权配置，详见API 总览与认证。

接口

POST /sessions/{session_id}

仅支持修改 title 与 metadata。会话更新是唯一会触发 session.updated 事件的操作。

请求示例

Bash

curl -X POST "$AGENTSTUDIO_URL/sessions/sesn_xxx" \
  -H "Authorization: Bearer $DASHSCOPE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Q3 销售复盘（已归档）",
    "metadata": {"biz_ticket_id": "1234", "status": "done"}
  }'

Python

session = client.sessions.update(
    "sesn_xxx",
    title="Q3 销售复盘（已归档）",
    metadata={"biz_ticket_id": "1234", "status": "done"},
)

Java

Map<String, String> metadata = new HashMap<>();
metadata.put("biz_ticket_id", "1234");
metadata.put("status", "done");

Session updated = client.sessions().update("sesn_xxx",
    SessionUpdateParam.builder()
        .title("Q3 销售复盘（已归档）")
        .metadata(metadata)
        .build());

响应示例

仅返回更新后的字段、updated_at 与 request_id。

{
  "id": "sesn_xxx",
  "type": "session",
  "status": "idle",
  "title": "Q3 销售复盘（已归档）",
  "metadata": {"biz_ticket_id": "1234", "status": "done"},
  "updated_at": "2026-05-28T09:30:00Z",
  "request_id": "xxx"
}

响应字段

字段	类型	说明
`id`	string	会话 ID
`type`	string	固定为 `session`
`status`	string	当前会话状态（更新不改变状态）
`title` / `metadata`	string / object	请求体覆盖后的新值
`updated_at`	string	最近更新时间，ISO 8601
`request_id`	string	本次请求的唯一标识