一、接口介绍
·批量操作：单次请求支持删除 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 | 当前存储实现不支持该操作。 |