一、接口介绍
·目标定位:通过 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 个文件”的提示。 |