diff --git a/docs/references/api.md b/docs/references/api.md
index b0012531b..974c87d4d 100644
--- a/docs/references/api.md
+++ b/docs/references/api.md
@@ -444,3 +444,27 @@ Get document list based on the knowledge base name and corresponding parameters.
 }
 
 ```
+
+## Delete document 
+
+Delete document by document id or document name.
+### Path: /api/document/rm/
+### Method: POST
+
+### Parameter:
+
+| Name        | Type   | Optional | Description                |
+|-------------|--------|----------|----------------------------|
+| `doc_names` | List   | Yes      | The list of document name. |
+| `doc_ids`   | List   | Yes      | The list of document id.   |
+
+
+### Response 
+```json
+{
+    "data": true,
+    "retcode": 0,
+    "retmsg": "success"
+}
+
+```