删除单个场景记忆

最近更新时间:2026-05-26 21:12:01

我的收藏

接口介绍

本接口(/scenario/delete)用于按完整路径删除一份场景记忆。通过 path 指定目标,系统按指向类型执行删除:
目标定位:通过 path 指定要删除的完整路径(必填)。
支持文件与目录path 既可指向场景记忆文件(如 工作/交付物/2026Q1.md),也可指向目录(以 / 结尾,如 工作/交付物/);删除目录时按系统约定的递归策略处理。

Method 与 URL

POST https://{服务访问地址}/v2/scenario/delete

使用示例

curl -i -k -X POST \\
-H 'Content-Type: application/json' \\
-H 'Authorization: Bearer ******************************' \\
-H "x-tdai-service-id: mem-8i8t****" \\
https://memory.tdai.tencentyun.com/v2/scenario/delete \\
-d '{
"path": "工作/交付物/2026Q1.md"
}'
说明:
鉴权说明:所有接口都必须在请求头中携带 Authorization: Bearer <API Key>x-tdai-service-id: <Service_ID>,否则将返回鉴权失败。

请求参数

参数名
类型
必填
描述说明
path
str
目标场景记忆的全路径(支持文件或目录)。系统会严格根据路径末尾是否包含斜杠 / 来判定删除行为,请谨慎传入:
单文件删除(末尾不带 /):例如 "工作/交付物/2026Q1.md",此时仅删除该指定文件。
目录级递归删除(末尾带 /):例如 "工作/交付物/",此时将彻底删除该目录及其下的所有子文件与子文件夹(高危操作,请务必前置二次确认)。

响应示例

{
"code": 0,
"message": "ok",
"path": "工作/交付物/2026Q1.md",
"deleted_count": 1
}
字段
类型
说明
path
str
被成功执行删除操作的目标路径。
deleted_count
int
整数类型,代表本次操作实际删除的文件总条数。
若执行的是单文件删除(路径不带 /),该值通常为 1。
若执行的是目录级递归删除(路径带 /),该值会显示该目录下被一并清空的所有文件总数(如 12),便于客户端向用户展示“已成功清理 X 个文件”的提示。