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. 回應格式保持不變

​
相關端點