Update a block

PATCH

/v1/blocks/{id}

Blocks

This endpoint allows you to update block content. See Full Documentation

Request Example

Shell

JavaScript

Java

Swift

curl --location --request PATCH '/v1/blocks/Identifier for a Notion block' \
--header 'Content-Type: application/json' \
--data-raw '{
    "paragraph": {
        "text": [
            {
                "text": {
                    "content": "hello to you"
                },
                "type": "text"
            }
        ]
    }
}'

Response Example

{
  "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": "green"
        },
        "plain_text": "Lacinato kale",
        "href": null
      }
    ],
    "color": "default",
    "is_toggleable": false
  }
}

Request

Path Params

string

required

Example:

Identifier for a Notion block

Body Params application/json

paragraph

object

optional

text

array [object {2}]

optional

to_do

object

required

rich_text

array [object {1}]

required

checked

boolean

required

Examples

Responses

🟢200200 Success - Update a block

application/json

Body

created_time

string

optional

Example:

2021-08-06T17:46:00.000Z

has_children

boolean

optional

Example:

false

string

optional

Example:

4868767d-9029-4b9d-a41b-652ef4c9c7b9

last_edited_time

string

optional

Example:

2021-08-12T00:12:00.000Z

object

string

optional

Example:

block

paragraph

object

optional

text

array [object {5}]

optional

type

string

optional

Example:

paragraph

Modified at 2023-04-28 09:13:56

Retrieve a block

Retrieve block children