接口介绍
本接口（
/v3/memory-prompt/delete）用于批量清理废弃的 Memory Prompt 定义。功能说明如下：批量操作：单次请求支持删除 1 至 100 份 Prompt，请求中的重复 ID 会被自动去重。
事务性保证：该操作为原子操作，任意 ID 不存在时整批删除失败，不会部分执行。
级联清除：删除 Prompt 时会同步清除所有引用该 Prompt 的实例级、团队级和 Agent 级设置，并写入清除日志。
Method 与 URL
POST https://memory.tdai.tencentyun.com/v3/memory-prompt/delete
使用示例
curl -i -X POST \\-H 'Content-Type: application/json' \\-H 'Authorization: Bearer *********************************' \\-H "x-tdai-service-id: tdai-mem-xxxxxxxx" \\https://memory.tdai.tencentyun.com/v3/memory-prompt/delete \\-d '{"memory_prompt_ids":["mp-550e8400-e29b-41d4-a716-446655440000","mp-660f9511-f30c-52e5-b827-557766551111"]}'
请求参数
参数 | 必选 | 参数含义 | 配置方法及要求 |
memory_prompt_ids | 是 | 待删除的 Prompt ID 列表 | 数据类型：Array<String> 数量限制：[1, 100] 重复 ID 会被服务端自动去重 |
响应示例
{"code":0,"message":"ok","request_id":"req-7fd3b2dd","data":{"deleted_prompt_ids":["mp-550e8400-e29b-41d4-a716-446655440000","mp-660f9511-f30c-52e5-b827-557766551111"],"cleared_settings":{"instance":1,"team":2,"agent":5}}}
响应参数说明
参数名（一级） | 参数名（二级） | 参数含义 |
data | deleted_prompt_ids | 本次实际删除的 Prompt ID 列表。 |
| cleared_settings | 本次删除操作级联清除的 Prompt 引用数量统计。 cleared_settings.instance：清除的实例级 Prompt 引用数量。 cleared_settings.team：清除的团队级 Prompt 引用数量。 cleared_settings.agent：清除的 Agent 级 Prompt 引用数量。 |
错误码
HTTP 状态码 | 错误信息 | 说明 |
400 | request: Invalid input | 请求参数不合法，如数组为空或超出 100 条上限。 |
401 | Missing or invalid Authorization header | Bearer API Key 缺失或格式不正确。 |
401 | Missing x-tdai-service-id header | 请求头中未携带 x-tdai-service-id。 |
404 | MEMORY_PROMPT_NOT_FOUND: batch delete requires every id to exist | 至少一个 Prompt ID 不存在，整批操作失败。 |
503 | Memory prompt store not available | Prompt 存储服务暂时不可用，请稍后重试。 |
503 | Memory prompt store does not support this operation | 当前存储实现不支持该操作。 |
