追加块子块

适用场景

当你要向某个 block 追加新的直接子块时使用这个接口。它适合增量写入正文结构，也支持控制插入位置。

接口信息

权限要求

需要 blocks.write。

请求参数

请求体示例：

{
  "children": [
    {
      "object": "block",
      "type": "to_do",
      "to_do": {
        "rich_text": [
          {
            "type": "text",
            "text": {
              "content": "补充监控告警"
            }
          }
        ],
        "checked": false
      }
    }
  ],
  "after": "12121212-1212-4212-8212-121212121212"
}

响应结果

{
  "object": "list",
  "results": [
    {
      "object": "block",
      "id": "14141414-1414-4414-8414-141414141414",
      "parent": {
        "type": "page_id",
        "page_id": "99999999-9999-4999-8999-999999999999"
      },
      "type": "to_do"
    }
  ],
  "next_cursor": null,
  "has_more": false
}

行为说明或限制

• children 使用 block input 结构，字段格式与页面创建时一致。
• after 可选；不传时会追加到末尾，传入时会插到指定子块之后。
• children 至多 100 个，且必须至少有 1 个。
• 仅支持可写的 block 类型；不支持的类型会被拒绝。

错误提示

• 400 validation_error：children 为空、超过上限，或 after 不是当前 block 的直接子块。
• 400 unsupported_block_type：传入了不支持写入的 block 类型。
• 401 unauthorized：token 无效或已过期。
• 403 forbidden：缺少 blocks.write 或无权访问父 block。
• 404 not_found：父 block 不存在。

相关文档

前置阅读

• 获取块子块

下一步

• 获取块
• Markdown 读取

相关参考

• Block 类型