Append block children

PATCH

https://api.notion.com/v1/blocks/{block_id}/children

Request Example

Shell

JavaScript

Java

Swift

curl --location --request PATCH 'https://api.notion.com/v1/blocks//children?block_id=' \
--header 'Notion-Version;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "children": [
        {
            "object": "string",
            "type": "string",
            "heading_2": {
                "rich_text": [
                    {
                        "type": "string",
                        "text": {
                            "content": "string"
                        }
                    }
                ]
            },
            "paragraph": {
                "rich_text": [
                    {
                        "type": "string",
                        "text": {
                            "content": "string",
                            "link": {
                                "url": "string"
                            }
                        }
                    }
                ]
            }
        }
    ]
}'

Response Example

200 - Success

{
  "object": "list",
  "results": [
    {
      "object": "block",
      "id": "c02fc1d3-db8b-45c5-a222-27595b15aea7",
      "parent": {
        "type": "page_id",
        "page_id": "59833787-2cf9-4fdf-8782-e53db20768a5"
      },
      "created_time": "2022-03-01T19:05:00.000Z",
      "last_edited_time": "2022-07-06T19:41:00.000Z",
      "created_by": {
        "object": "user",
        "id": "ee5f0f84-409a-440f-983a-a5315961c6e4"
      },
      "last_edited_by": {
        "object": "user",
        "id": "ee5f0f84-409a-440f-983a-a5315961c6e4"
      },
      "has_children": false,
      "archived": false,
      "type": "heading_2",
      "heading_2": {
        "rich_text": [
          {
            "type": "text",
            "text": {
              "content": "Lacinato kale",
              "link": null
            },
            "annotations": {
              "bold": false,
              "italic": false,
              "strikethrough": false,
              "underline": false,
              "code": false,
              "color": "default"
            },
            "plain_text": "Lacinato kale",
            "href": null
          }
        ],
        "color": "default",
        "is_toggleable": false
      }
    },
    {
      "object": "block",
      "id": "acc7eb06-05cd-4603-a384-5e1e4f1f4e72",
      "parent": {
        "type": "page_id",
        "page_id": "59833787-2cf9-4fdf-8782-e53db20768a5"
      },
      "created_time": "2022-03-01T19:05:00.000Z",
      "last_edited_time": "2022-07-06T19:51:00.000Z",
      "created_by": {
        "object": "user",
        "id": "ee5f0f84-409a-440f-983a-a5315961c6e4"
      },
      "last_edited_by": {
        "object": "user",
        "id": "0c3e9826-b8f7-4f73-927d-2caaf86f1103"
      },
      "has_children": false,
      "archived": false,
      "type": "paragraph",
      "paragraph": {
        "rich_text": [
          {
            "type": "text",
            "text": {
              "content": "Lacinato kale is a variety of kale with a long tradition in Italian cuisine, especially that of Tuscany. It is also known as Tuscan kale, Italian kale, dinosaur kale, kale, flat back kale, palm tree kale, or black Tuscan palm.",
              "link": {
                "url": "https://en.wikipedia.org/wiki/Lacinato_kale"
              }
            },
            "annotations": {
              "bold": false,
              "italic": false,
              "strikethrough": false,
              "underline": false,
              "code": false,
              "color": "default"
            },
            "plain_text": "Lacinato kale is a variety of kale with a long tradition in Italian cuisine, especially that of Tuscany. It is also known as Tuscan kale, Italian kale, dinosaur kale, kale, flat back kale, palm tree kale, or black Tuscan palm.",
            "href": "https://en.wikipedia.org/wiki/Lacinato_kale"
          }
        ],
        "color": "default"
      }
    }
  ],
  "next_cursor": null,
  "has_more": false,
  "type": "block",
  "block": {}
}

Request

Path Params

block_id

string

required

Query Params

block_id

string

required

Identifier for a block

Header Params

Notion-Version

string

required

Body Params application/json

children

array [object {4}]

required

object

string

required

type

string

required

heading_2

object

optional

paragraph

object

optional

Examples

Responses

🟢200OK

application/json

Body

object {0}

🟠400Bad Request

Modified at 2023-04-28 08:49:29

Delete a block

Retrieve a block