使用说明

删除文档 / 空间

通用鉴权与 Base URL 见 HTTP API 总览。

可删除：单篇文档、多篇文档、整个空间。

删除单个文档

DELETE /v1/documents/{doc_id}
Authorization: Bearer <token>

成功：204。

说明：

  • 文档在库中标记为 归档（archived = true），列表接口默认不再返回
  • 会尝试删除对象存储中该文档对应前缀；失败不阻断接口成功
  • HTTP 不会拦截概览 / 日志页；MCP delete 会保护 overview.md / log.md。若需保留结构页，勿对它们调用本接口

批量删除文档

POST /v1/documents/bulk-delete
Authorization: Bearer <token>
Content-Type: application/json

{ "ids": ["<uuid1>", "<uuid2>"] }

成功：204。空数组亦成功。行为与单删一致（归档 + 尝试清存储）。

删除整个空间

DELETE /v1/knowledge-bases/{kb_id}
Authorization: Bearer <token>

成功：204。
失败：404（不存在或无权）。

删除该空间行后，数据库会级联删除其下文档、分块等关联数据，不可恢复。对象存储中的文件未必同步清理，请谨慎调用。

相关