Blocks

Append block children

Changed on
patch/v1/blocks/{block_id}/children

Request

  • Base URL
    https://api.notion.com
  • URL
    https://api.notion.com/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

  • 8967a2a7b255Revision changes
    • info

      added the optional property ///////// to the response with the status

    • info

      added the required property //////// to the response with the status

  • ed50532d1d7eRevision changes
    • info

      added the new optional request property