数据生命周期

数据通过结构化记录与文件流入。结构化读数会被标准化；上传文件保留原件与抽取文本。二者都可以为智能体回答提供依据。本页把这个环闭上：数据如何离开 —— 由你决定。三个出口，从自动到彻底：

留存过期 —— 有时限的写入（1h / 2h / 6h / 1d）自行过期；见数据留存。
删除会话 —— 一次调用拆除一个有名字的工作范围（见下）。
下线 Subject —— 一次调用擦除该 Subject 的一切（见下）。

会话

session_id 可以同时标识工作数据范围与 Agent 对话：

限定 retention=session 数据 —— 通过 POST /v1/data（或 POST /v1/extract 的 store=true）以 retention: "session" 写入的记录必须携带 session_id，存活到会话被删除为止 —— 清除靠的就是删除会话这一步，别省略它。
在 Agent API 上绑定永续对话 —— 给 POST /v1/responses 传 session_id 会让对话在该 id 下永续、可恢复。见状态与记忆。

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

结束工作数据范围：以此 session_id 写入、retention=session 的记录被擦除（连同其 FHIR 镜像），会话档位的文件上传被移除，底层聊天会话被标记为已结束。

此端点不会删除已存储的 Responses API 对象。使用同一 session_id 创建的响应仍可通过 GET /v1/responses/{id} 获取，也仍可继续串联。请通过 DELETE /v1/responses/{id} 删除响应对象；需要擦除该 Subject 的全部存储响应时，请使用 Subject 下线。

curl -X DELETE "https://api.mirobody.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" }

deleted 统计会话范围的记录、文件与底层聊天会话行，不包含已存储的 Responses API 对象。0 表示这几类资源均未匹配。

import requests

BASE = "https://api.mirobody.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"})

下线一个 Subject

DELETE /v1/subjects/{user}
Authorization: Bearer mb_live_*

一次调用实现被遗忘权。它擦除该 Subject 的一切：

结构化记录 —— 经 POST /v1/data 写入或存储的抽取结果的一切，无论 retention 为何 —— 包括其 FHIR 资源。
文件 —— 经 POST /v1/files 上传的一切，立即从 API 中消失。
存储的 Agent API 对话 —— 立即不可再读取（GET /v1/responses/{id} 返回 404），随后由后台任务清除。
身份映射 —— Subject 本身变得不可达。之后传入同一 user 的请求会铸造一个全新的空 Subject，与被擦除的那个毫无关联。

curl -X DELETE "https://api.mirobody.ai/v1/subjects/alice" \
  -H "Authorization: Bearer $MIROBODY_API_KEY"

擦除绝不会创建它正要擦除的那个 Subject：解析只查找已有映射。传入一个你的账户从未用过的 user 会返回 404 —— 不会铸造任何新 Subject。

{ "status": "ok", "subject": "alice", "deleted": { "records": 12, "files": 3, "conversations": 5 } }

字段	说明
`deleted.records`	被擦除的结构化健康记录条数。
`deleted.files`	从 API 中移除的文件数。
`deleted.conversations`	被移除的存储 Agent API 对话数。

需要更细粒度的删除时，改用按件的删除层级：DELETE /v1/data（记录）、DELETE /v1/files/{key}（单个文件）、DELETE /v1/responses/{id}（单个存储响应）、DELETE /v1/sessions/{id}（会话范围的数据与文件）。完整的用户权利图景见合规。

错误

HTTP	何时
`404`	`DELETE /v1/subjects/{user}`：你的账户没有此 `user` 对应的 Subject —— 包括已被擦除的

开始使用

数据面

Agent API

Answers API

区域与接入

数据生命周期

会话

下线一个 Subject

错误

​会话

​下线一个 Subject

​错误

会话

下线一个 Subject

错误