Skip to main content
Session and Event

更新 Session

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

前提

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

接口

POST /sessions/{session_id} 仅支持修改 titlemetadata会话更新是唯一会触发session.updated事件的操作

请求示例

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"}
  }'

响应示例

仅返回更新后的字段、updated_atrequest_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

本次请求的唯一标识