更新 Session

更新 Session 的可变属性，如标题或元数据。

POST /v1/sessions/{session_id}

更新 Session 的可变属性（如标题、元数据）。仅传入需要修改的字段。

​

请求头

头部	必选	说明
Authorization	是	Bearer <PAT>
Content-Type	是	application/json

​

路径参数

参数	类型	必选	说明
session_id	string	是	Session ID（sess_ 前缀）

​

请求体

字段	类型	必选	说明
title	string	否	新的会话标题
metadata	object	否	元数据补丁。服务端会与现有 metadata 合并。
delta_flush_interval_ms	integer	否	增量刷新间隔，单位毫秒，范围 50-5000。

​

示例请求

curl -X POST "https://api.qoder.com/api/v1/cloud/sessions/sess_019e3bb1e8c171fd9abbb1477ffb84cc" \
  -H "Authorization: Bearer $QODER_PAT" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "新标题",
    "metadata": {"priority": "high"},
    "delta_flush_interval_ms": 250
  }'

​

示例响应

HTTP 200 OK

返回更新后的完整 Session 对象，updated_at 字段会被刷新。

{
  "agent": {
    "created_at": "2026-05-27T08:22:05.558081Z",
    "description": "",
    "id": "agent_019e6886cdf5778098368adde92a2a02",
    "mcp_servers": [],
    "metadata": {},
    "model": "ultimate",
    "name": "Hello World Agent",
    "skills": [],
    "system": "你是一个通用助手，能够研究、写代码、运行命令，并使用工具端到端地完成任务。",
    "tools": [
      {
        "enabled_tools": ["WebFetch", "WebSearch", "Bash", "Glob", "Read", "Grep", "Write", "Edit"],
        "type": "agent_toolset_20260401"
      }
    ],
    "type": "agent",
    "updated_at": "2026-05-27T10:09:09.542948Z",
    "version": 3
  },
  "agent_id": "agent_019e6886cdf5778098368adde92a2a02",
  "created_at": "2026-05-27T15:30:48.336828Z",
  "environment_id": "env_019e6954e74770d6bce983cdb53be448",
  "id": "sess_019e6a0f4d9170a989eee39f6685f3fb",
  "memory_store_ids": [],
  "environment_variables": {},
  "metadata": {"priority": "high"},
  "resources": [
    {
      "file_id": "file_019e6a18dc0978e9a2104c9b269748ac",
      "path": "/data/data/data/file_019e6a18dc0978e9a2104c9b269748ac",
      "type": "file"
    }
  ],
  "status": "idle",
  "stats": {"active_seconds": 0, "duration_seconds": 0},
  "title": "doc-test-title",
  "turn_status": "idle",
  "type": "session",
  "updated_at": "2026-05-28T02:09:42.156418Z",
  "vault_ids": [],
  "archived_at": null
}

​

响应字段

响应结构与获取 Session一致。

​

错误码

HTTP	type	触发条件
400	invalid_request_error	请求体格式错误
401	authentication_error	PAT 无效或过期
404	not_found_error	Session 不存在

完整错误信封说明详见 错误参考。

​

相关

启动 Session

让 Agent 在环境中以有状态对话的方式运行。