DELETE
/
api
/
knowledgebases
/
{knowledgebaseId}
/
datasets
/
{datasetId}
删除数据集
curl --request DELETE \
  --url https://app.pathors.com/api/knowledgebases/{knowledgebaseId}/datasets/{datasetId} \
  --header 'x-api-key: <x-api-key>'
{
  "message": "<string>"
}

​
删除数据集

从指定的知识库中永久移除数据集，包括所有相关的块和嵌入向量。

​
端点

DELETE /api/knowledgebases/{knowledgebaseId}/datasets/{datasetId}

​
路径参数

​
knowledgebaseId
string
required
包含数据集的知识库的唯一标识符
​
datasetId
string
required
要删除的数据集的唯一标识符

​
请求头

​
x-api-key
string
required
您的项目API密钥用于身份验证
请求示例: 
curl -X DELETE \
  -H "x-api-key: your_api_key" \
  https://your-domain.com/api/knowledgebases/kb_abc123/datasets/dataset_xyz789

​
响应

返回确认删除的成功消息。
​
message
string
确认数据集已成功删除的消息
响应示例: 
{
  "message": "Dataset deleted successfully"
}

​
错误响应

状态码描述
400缺少知识库ID或数据集ID
401无效的API密钥
403数据集不属于指定的知识库
404知识库或数据集未找到
500内部服务器错误

​
删除过程

  1. 验证: 验证知识库存在并属于您的项目
  2. 数据集验证: 确保数据集存在并属于该知识库
  3. 块删除: 删除与数据集相关的所有文本块
  4. 嵌入清理: 从搜索索引中删除向量嵌入
  5. 文件删除: 删除原始上传的文件
  6. 数据库清理: 从数据库中删除数据集元数据

​
重要说明

​
永久操作

  • 此操作无法撤销
  • 所有块和嵌入向量都将被永久删除
  • 原始文件也会从存储中删除

​
搜索影响

  • 查询将不再返回此数据集的结果
  • 现有搜索结果可能立即受到影响
  • 相关块将不再出现在搜索结果中

​
验证

  • 数据集必须属于指定的知识库
  • 交叉验证防止从错误的知识库意外删除
  • API密钥必须有权访问包含知识库的项目

​
使用说明

  • 如果需要保留原始文件，请确保有备份
  • 考虑对使用此数据集的现有应用程序的影响
  • 大数据集可能需要一些时间才能完全清理
  • 操作是原子性的 - 要么所有清理都成功，要么什么都不删除

​
从旧端点迁移

如果您正在从已弃用的 /api/datasets/{filename} 端点迁移:
  1. 使用获取知识库获取您的知识库ID
  2. 从获取知识库中的数据集获取数据集ID
  3. 更新您的API调用以在URL路径中使用两个ID
  4. 响应格式保持不变

​
相关端点