文档管理

删除文档

从知识库中删除文档及其所有关联切片

POST

/api/v1/indices/rag/index/delete_file

cURL

curl -X POST "https://{workspaceId}.cn-beijing.maas.aliyuncs.com/api/v1/indices/rag/index/delete_file" \
  -H "Authorization: Bearer $DASHSCOPE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "index_id": "your_index_id",
    "doc_ids": ["file_xxx"]
  }'

{
  "code": "Success",
  "status_code": 200,
  "data": {
    "deleted": []
  },
  "success": true,
  "message": "success",
  "request_id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "status": "SUCCESS"
}

此操作不可逆。此接口使用 snake_case 参数名 index_id、doc_ids，与其他接口的 camelCase（indexId）不同。传 IndexId 或 indexId 都会返回 Index.InvalidParameter。参数缺失时服务端返回的 Required parameter(IndexId) missing or invalid，其中 IndexId 是服务端内部字段名，不是请求参数名，请仍按 index_id 传参。

Authorizations

string

header

required

DashScope API Key，在控制台 API Key 页面获取。

Body

application/json

string

required

知识库 ID。

string[]

required

要删除的文档 ID 列表。

Response

200-application/json

string

响应码，成功时为 Success。

integer

HTTP 状态码。

string

请求唯一标识，排查问题时请提供此 ID。

object

Show child attributes

string[]

已删除的文档 ID 列表。

boolean

操作是否成功。

string

响应消息，成功时为 success。

string

请求状态：SUCCESS 或 FAILED。

cURL

curl -X POST "https://{workspaceId}.cn-beijing.maas.aliyuncs.com/api/v1/indices/rag/index/delete_file" \
  -H "Authorization: Bearer $DASHSCOPE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "index_id": "your_index_id",
    "doc_ids": ["file_xxx"]
  }'

{
  "code": "Success",
  "status_code": 200,
  "data": {
    "deleted": []
  },
  "success": true,
  "message": "success",
  "request_id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "status": "SUCCESS"
}