删除记忆版本正文
永久删除一个历史版本的正文,仅保留其元数据。已删除的正文无法恢复。
- 只影响所选版本。当前文件和其他版本不受影响。
- 文件当前对应的版本不能删除正文(400
failed_precondition_error)。对已经删除过正文的版本重复执行是空操作。
POST
删除记忆版本正文
请求头
本次请求使用的 API 版本,格式为 YYYY-MM-DD。发送 2026-09-01-beta 即使用本文档所述版本。/v1/files* 之外必传:未携带请求头将被拒绝并返回 400 invalid_request_error;在 /v1/files* 上缺省时选择兼容行为。所有端点对未知取值均返回 400 invalid_request_error。
平台当前支持的 API 版本。新的日期版本发布时加入;版本在公告的 Sunset 日期后移除。
可用选项:
2026-09-01-beta 响应
已设置 redacted_at 的版本。
对记忆文件一次更改的不可变记录。
每次变更都会记录,包括从未成为文件当前状态的乱序写入。
记忆版本 ID。
所属记忆库的 ID。
被更改文件的稳定记忆 ID。
更改后的文件路径。
此版本记录的文件操作。
可用选项:
created, modified, deleted, renamed 更改的来源(api 或 session)。
可用选项:
api, session 平台接受此版本记录的时间。
历史文件正文,经 base64 编码。deleted 版本以及正文被删除后不返回。
更改后内容的 SHA-256。删除时缺省。
更改后内容的大小,单位为字节。删除时缺省。
产生此更改的会话。仅当 source 为 session 时存在。
历史正文被删除的时间。可读期间缺省。
在成为过文件当前状态的版本序列中的单调位置。从未成为当前状态的乱序写入缺省。