会话 - Mirobody

端点

DELETE /v1/sessions/{session_id}
Authorization: Bearer mb_live_*

结束一个会话并清理其范围内的内容：以此 session_id 写入、retention=session 的记录会被硬删除（行被物理移除），线程在此会话上的聊天历史也会从 API 表面移除。deleted 统计清除的数量。

curl -X DELETE "https://mirobody-api.thetahealth.ai/v1/sessions/sess_abc123?user=alice" \
  -H "Authorization: Bearer $MIROBODY_API_KEY"

传入与写入该会话数据时相同的 user；省略则指向你账户的默认 Subject。

响应：

{ "status": "ok", "session_id": "sess_abc123", "deleted": 2, "subject": "alice" }

字段	说明
`status`	成功时为 `"ok"`。
`session_id`	被结束的会话。
`deleted`	清除条目计数（会话范围的数据记录 + 对话行）。`0` 只表示没有内容限定在此会话。
`subject`	会话所属的 Subject。

会话如何工作

session_id 是一个有名字的清理范围 —— 用一个 id 把一次交互的工作数据与对话绑在一起：

限定 retention=session 数据 —— 通过 POST /v1/data（或 POST /v1/extract 的 store=true）以 retention: "session" 写入的记录必须携带 session_id，且只存活到会话被删除为止（无论如何上限 24 小时）。
在 Agent API 上绑定永续对话 —— 给 POST /v1/responses 传 session_id 会让对话在该 id 下永续、可恢复。见状态与记忆。

import requests

BASE = "https://mirobody-api.thetahealth.ai/v1"
H = {"Authorization": "Bearer mb_live_..."}

# 写入限定在会话内的工作数据
requests.post(f"{BASE}/data", headers=H, json={
    "user": "alice",
    "retention": "session",
    "session_id": "sess_abc123",
    "records": [{"indicator": "systolic_bp", "value": 148, "unit": "mmHg",
                 "time": "2026-06-16T08:00:00Z"}],
})

# ... 用 session_id="sess_abc123" 运行 agent 轮次 ...

# 交互结束时，清除其范围内的一切：
requests.delete(f"{BASE}/sessions/sess_abc123", headers=H, params={"user": "alice"})

完整生命周期模型见留存。

​端点

​会话如何工作

端点

会话如何工作