Update a block
PATCH/v1/blocks/{id}This endpoint allows you to update block content. See Full Documentation
Request
Path Params
id
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
Example
{
"paragraph": {
"text": [
{
"text": {
"content": "hello to you"
},
"type": "text"
}
]
}
}Request samples
Responses
200 Success - Update a block(200)
200 Success - Update a block
HTTP Code: 200
Content Type : JSONapplication/json
Data Schema
created_time
string
optional
Example:
2021-08-06T17:46:00.000Z
has_children
boolean
optional
Example:
false
id
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
Example200 Success - Update a block
{
"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
}
}Last modified: 2 years ago