如何使用Notion API在父块的指定位置插入子页面/子块

插入到列表最开头（child page 4 插入需求） #

Notion 的 PATCH 块子节点接口本身支持自定义插入位置，并非只能追加到末尾，你只需要使用可选的 after 参数即可：

• 先调用检索块子节点接口，获取父页面下所有子块的 ID 映射，确认当前排序的首块（也就是 child page 3）的 ID
• 调用 PATCH 接口时，将 after 参数设置为 null（部分SDK 支持传递空值标识头部插入），即可将新建的 child page 4 直接插入到列表最顶部
• 如果 SDK 不支持空值传参，可以采用全量重排方案：将你需要的完整排序的块 ID 数组（child page 4 ID 放在第一位，后续跟原有三个子页的 ID）一次性通过 children 参数提交，覆盖原有排序即可

插入到两个子页中间（child page 2.5 插入需求） #

当前子页的排序为：child page 3 → child page 2 → child page 1，你需要的插入位置刚好是 child page 3 的后一位，操作如下：

• 从之前获取的子块 ID 映射中找到 child page 3 对应的块 ID
• 调用 PATCH 接口时，将 after 参数设置为 child page 3 的块 ID，即可将 child page 2.5 精准插入到 child page 3 和 child page 2 之间

内容的提问来源于stack exchange，提问作者Bahriddin Abdiev