获取 Session

根据 ID 获取单个 Session 的完整信息。

GET /v1/sessions/{session_id}

根据 ID 获取单个 Session 的完整信息。

​

请求头

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

​

路径参数

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

​

示例请求

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

​

示例响应

HTTP 200 OK

返回完整的 Session 对象（结构同创建响应）。

{
  "id": "sess_019e3bb1e8c171fd9abbb1477ffb84cc",
  "type": "session",
  "agent_id": "agent_019e390add9f7bac9b6cc806db46fcbd",
  "agent": {
    "id": "agent_019e390add9f7bac9b6cc806db46fcbd",
    "type": "agent",
    "name": "test-agent-e2e",
    "model": "ultimate",
    "system": "你是一个测试助手。",
    "tools": [],
    "mcp_servers": [],
    "skills": [],
    "metadata": {},
    "version": 2,
    "archived_at": null,
    "created_at": "2026-05-18T03:04:33.952256Z",
    "updated_at": "2026-05-18T03:05:28.023697Z"
  },
  "environment_id": "env_019e2590d33f711fabf42f2857cecd8a",
  "title": "API-doc-verification-session",
  "status": "idle",
  "turn_status": "idle",
  "metadata": {},
  "resources": [],
  "vault_ids": [],
  "memory_store_ids": [],
  "environment_variables": {},
  "stats": {
    "active_seconds": 0,
    "duration_seconds": 0
  },
  "archived_at": null,
  "created_at": "2026-05-18T15:26:15.747298Z",
  "updated_at": "2026-05-18T15:26:15.747298Z"
}

​

响应字段

响应结构与创建 Session中的 Session 对象一致。嵌套的 agent 是本 Session 使用的快照，不包含旧字段 instructions 或 default_environment。

​

错误码

HTTP	type	触发条件
401	authentication_error	PAT 无效或过期
404	not_found_error	Session 不存在

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

​

相关

启动 Session

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