diff --git a/API.md b/API.md
index d8f28fa8e..f7eea2206 100644
--- a/API.md
+++ b/API.md
@@ -502,13 +502,20 @@ View API token in Settings - About, request header: `Authorization: T
{
"dataType": "markdown",
"data": "foo**bar**{: style=\"color: var(--b3-font-color8);\"}baz",
- "previousID": "20211229114650-vrek5x6"
+ "nextID": "",
+ "previousID": "20211229114650-vrek5x6",
+ "parentID": ""
}
```
* `dataType`: The data type to be inserted, the value can be `markdown` or `dom`
* `data`: Data to be inserted
+ * `nextID`: The ID of the next block, used to anchor the insertion position
* `previousID`: The ID of the previous block, used to anchor the insertion position
+ * `parentID`: The ID of the parent block, used to anchor the insertion position
+
+ `nextID`, `previousID`, and `parentID` must have at least one value, using
+ priority: `nextID` > `previousID` > `parentID`
* Return value
```json
@@ -781,8 +788,8 @@ View API token in Settings - About, request header: `Authorization: T
}
```
- * `id`: Parent block ID
- * The blocks below a heading are also counted as child blocks
+ * `id`: Parent block ID
+ * The blocks below a heading are also counted as child blocks
* Return value
```json
diff --git a/API_zh_CN.md b/API_zh_CN.md
index 2123c1ac7..01c0d7f44 100644
--- a/API_zh_CN.md
+++ b/API_zh_CN.md
@@ -496,13 +496,19 @@
{
"dataType": "markdown",
"data": "foo**bar**{: style=\"color: var(--b3-font-color8);\"}baz",
- "previousID": "20211229114650-vrek5x6"
+ "nextID": "",
+ "previousID": "20211229114650-vrek5x6",
+ "parentID": ""
}
```
* `dataType`:待插入数据类型,值可选择 `markdown` 或者 `dom`
* `data`:待插入的数据
+ * `nextID`:后一个块的 ID,用于锚定插入位置
* `previousID`:前一个块的 ID,用于锚定插入位置
+ * `parentID`:父块 ID,用于锚定插入位置
+
+ `nextID`、`previousID`、`parentID` 三个参数必须至少存在一个有值,优先级为 `nextID` > `previousID` > `parentID`
* 返回值
```json
@@ -774,8 +780,8 @@
}
```
- * `id`:父块 ID
- * 标题下方块也算作子块
+ * `id`:父块 ID
+ * 标题下方块也算作子块
* 返回值
```json