更新 Session 的可變屬性(如標題、中繼資料)。僅傳入需要修改的欄位。
要求標頭
|
頭部 |
必選 |
說明 |
|
|
是 |
|
|
|
是 |
|
路徑參數
|
參數 |
類型 |
必選 |
說明 |
|
|
string |
是 |
Session ID( |
請求體
|
欄位 |
類型 |
必選 |
說明 |
|
|
string |
否 |
新的會話標題 |
|
|
object |
否 |
新的中繼資料(整體替換) |
樣本請求
curl -X POST "https://api.qoder.com.cn/api/v1/cloud/sessions/sess_019e3bb1e8c171fd9abbb1477ffb84cc" \
-H "Authorization: Bearer $QODER_PAT" \
-H "Content-Type: application/json" \
-d '{
"title": "新標題",
"metadata": {"priority": "high"}
}'
樣本響應
HTTP 200 OK
返回更新後的完整 Session 對象,updated_at 欄位會被重新整理。
{
"agent": {
"created_at": "2026-05-27T08:22:05.558081Z",
"default_environment": "",
"description": "",
"id": "agent_019e6886cdf5778098368adde92a2a02",
"instructions": "你是一個通用助手,能夠研究、寫代碼、運行命令,並使用工具端到端地完成任務。",
"mcp_servers": [],
"model": "ultimate",
"name": "Hello World Agent",
"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": [],
"resources": [
{
"file_id": "file_019e6a18dc0978e9a2104c9b269748ac",
"path": "/data/data/data/file_019e6a18dc0978e9a2104c9b269748ac",
"type": "file"
}
],
"status": "idle",
"title": "doc-test-title",
"turn_status": "idle",
"type": "session",
"updated_at": "2026-05-28T02:09:42.156418Z",
"vault_ids": []
}
嵌套的 agent 對象不含 archived / archived_at 欄位(與頂層 GET /agents 響應不同)。
錯誤碼
|
HTTP |
type |
觸發條件 |
|
400 |
|
請求體格式錯誤 |
|
401 |
|
PAT 無效或到期 |
|
404 |
|
Session 不存在 |
完整錯誤信封說明詳見 錯誤參考。