Session & Event

更新 Session

更新会话元数据

POST

/api/v1/agentstudio/sessions/{session_id}

cURL

curl --request POST \
  --url 'https://dashscope.aliyuncs.com/api/v1/agentstudio/sessions/{session_id}' \
  --header 'Authorization: Bearer <YOUR_API_KEY>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "title": "Q3 销售复盘（已归档）",
  "metadata": {
    "biz_ticket_id": "1234",
    "status": "done"
  },
  "environment_variables": {
    "API_BASE_URL": "https://api.example.com",
    "LOG_LEVEL": "info"
  }
}
'

{
  "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",
  "environment_variables": {
    "API_BASE_URL": "https://api.example.com",
    "LOG_LEVEL": "info"
  }
}

鉴权

string

header

必填

DashScope API Key

路径参数

string

必填

请求体

application/json

string

会话标题

object

业务自定义键值

object

会话运行时注入的环境变量，字符串键值对，沙箱代码中可直接按名读取

响应

200-application/json

string

会话 ID

string

固定为 session

enum<string>

当前会话状态（更新不改变状态）

可选值：idle,running,terminated

string

请求体覆盖后的新值

object

请求体覆盖后的新值

string

最近更新时间，ISO 8601

string

本次请求的唯一标识

object

会话运行时注入的环境变量

cURL

curl --request POST \
  --url 'https://dashscope.aliyuncs.com/api/v1/agentstudio/sessions/{session_id}' \
  --header 'Authorization: Bearer <YOUR_API_KEY>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "title": "Q3 销售复盘（已归档）",
  "metadata": {
    "biz_ticket_id": "1234",
    "status": "done"
  },
  "environment_variables": {
    "API_BASE_URL": "https://api.example.com",
    "LOG_LEVEL": "info"
  }
}
'

{
  "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",
  "environment_variables": {
    "API_BASE_URL": "https://api.example.com",
    "LOG_LEVEL": "info"
  }
}