From 42504fa18c45a8f2e7ec8c620a1c66c23ea02e89 Mon Sep 17 00:00:00 2001
From: Wang Qi <wangq8@outlook.com>
Date: Sat, 9 May 2026 13:03:09 +0800
Subject: [PATCH] Bugfix: keep document api backward compatible (#14726)

### What problem does this PR solve?

Bugfix: keep document api backward compatible

Fix 1: https://github.com/infiniflow/ragflow/issues/14634

### Type of change

- [x] Bug Fix (non-breaking change which fixes an issue)
---
 api/apps/backward_compat.py | 20 +++++++++++++++++++-
 1 file changed, 19 insertions(+), 1 deletion(-)

diff --git a/api/apps/backward_compat.py b/api/apps/backward_compat.py
index b7c5230245..0ddb65d72a 100644
--- a/api/apps/backward_compat.py
+++ b/api/apps/backward_compat.py
@@ -371,7 +371,7 @@ async def deprecated_update_chunk(dataset_id, document_id, chunk_id):
         dataset_id, document_id, chunk_id,
     )
     # Forward to the new API implementation
-    return await chunk_api.update_chunk(dataset_id, document_id, chunk_id)
+    return await chunk_api.update_chunk(dataset_id=dataset_id, document_id=document_id, chunk_id=chunk_id)
 
 
 # =============================================================================
@@ -403,6 +403,24 @@ async def deprecated_file_upload_info():
 # Document APIs
 # =============================================================================
 
+@manager.route("/datasets/<dataset_id>/documents/<document_id>", methods=["PUT"])
+@login_required
+async def deprecated_update_document(dataset_id, document_id):
+    """
+    Deprecated: Use PATCH /api/v1/datasets/{dataset_id}/documents/{document_id} instead.
+
+    Old path: PUT /api/v1/datasets/{dataset_id}/documents/{document_id}
+    New path: PATCH /api/v1/datasets/{dataset_id}/documents/{document_id}
+    """
+    logging.warning(
+        "API endpoint PUT /api/v1/datasets/%s/documents/%s is deprecated. "
+        "Please use PATCH instead.",
+        dataset_id, document_id,
+    )
+    # Forward to the new API implementation
+    return await document_api.update_document(dataset_id=dataset_id, document_id=document_id)
+
+
 @manager.route("/document/get/<doc_id>", methods=["GET"])
 @login_required
 async def deprecated_document_get(doc_id):