Blocks

Append block children

patch/v1/blocks/{block_id}/children

Request

Base URL
https://api.notion.com/admin
URL
https://api.notion.com/admin/v1/blocks/{block_id}/children
Auth
HTTP bearer

Path parameters

block_idstring required

Headers

Notion-Version'2026-03-11' required

The API version to use for this request. The latest version is 2026-03-11.

Request body

Example request

{
  "children": [
    {
      "embed": {
        "caption": [
          {
            "text": {
              "link": {
                "url": "https://www.notion.com"
              }
            }
          }
        ]
      }
    }
  ]
}

Response

type'block' required

blockEmptyObject required

object'list' required

next_cursorstring nullable required

has_moreboolean required

Changes

No recorded changes to this operation across all 1 revision of this API.