跳转到主要内容
POST /v1/sessions/{session_id}/archive 将 Session 归档。归档后的 Session 不再出现在默认列表中（需传 include_archived=true 查询参数才能列出），但数据保留。
与 Environment 和 Vault 不同，Session 归档后 status 字段保持为 "idle"，不会变为 "archived"。归档效果仅体现在默认列表不返回该 Session。当前 API 无 unarchive/restore 端点。

​
请求头

头部必选说明
Authorization是Bearer <PAT>

​
路径参数

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

​
示例请求

curl -X POST "https://api.qoder.com/api/v1/cloud/sessions/sess_019e3bb1e8c171fd9abbb1477ffb84cc/archive" \
  -H "Authorization: Bearer $QODER_PAT"

​
示例响应

HTTP 200 OK 返回完整的 Session 对象。 
{
  "id": "sess_019e3bb1e8c171fd9abbb1477ffb84cc",
  "type": "session",
  "agent_id": "agent_019e390add9f7bac9b6cc806db46fcbd",
  "environment_id": "env_019e2590d33f711fabf42f2857cecd8a",
  "title": "API-doc-verification-session-updated",
  "status": "idle",
  "turn_status": "idle",
  "metadata": {},
  "resources": [],
  "vault_ids": [],
  "memory_store_ids": [],
  "environment_variables": {},
  "stats": {"active_seconds": 0, "duration_seconds": 0},
  "archived_at": "2026-05-18T15:26:35.5596Z",
  "created_at": "2026-05-18T15:26:15.747298Z",
  "updated_at": "2026-05-18T15:26:35.5596Z"
}

​
响应字段

响应结构与获取 Session一致。归档会设置 archived_at；status 字段本身不会变成 "archived"。

​
错误码

HTTPtype触发条件
401authentication_errorPAT 无效或过期
404not_found_errorSession 不存在
完整错误信封说明详见 错误参考。

​
相关

启动 Session

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