{
  "openapi": "3.0.3",
  "info": {
    "title": "知识库商户隔离增量接口",
    "version": "2026-07-28",
    "description": "仅记录本次兼容性接口变化。dataset_id 用于精确执行文件对象级归属校验；旧客户端省略时，后端会在当前 BUSINESS 所属知识库内逐一验证。"
  },
  "paths": {
    "/p/knowledgeBase/deleteDocument": {
      "post": {
        "summary": "删除知识库文件",
        "requestBody": {
          "required": true,
          "content": {
            "application/x-www-form-urlencoded": {
              "schema": {
                "type": "object",
                "required": [
                  "document_ids"
                ],
                "properties": {
                  "dataset_id": {
                    "type": "string",
                    "description": "建议传入。目标知识库 ID，服务端会验证其名称以当前 BUSINESS 前缀开头。"
                  },
                  "document_ids": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    },
                    "minItems": 1
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "沿用现有统一响应结构；无权操作时 code 非 0。"
          }
        }
      }
    },
    "/p/knowledgeBase/updateDocument": {
      "post": {
        "summary": "更新知识库文件",
        "requestBody": {
          "required": true,
          "content": {
            "application/x-www-form-urlencoded": {
              "schema": {
                "type": "object",
                "required": [
                  "document_id"
                ],
                "properties": {
                  "dataset_id": {
                    "type": "string",
                    "description": "建议传入。目标知识库 ID，服务端会验证知识库和文件归属。"
                  },
                  "document_id": {
                    "type": "string"
                  },
                  "document_name": {
                    "type": "string"
                  },
                  "update_rule": {
                    "type": "object"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "沿用现有统一响应结构；无权操作时 code 非 0。"
          }
        }
      }
    }
  }
}