ブロックの子を追加
PATCH
/v1/blocks/{block_id}/children
block_idに追加します。📘ブロックは移動できません
ブロックは、親ブロックの下部に追加されます。ブロックが子として追加されると、API を介して別の場所に移動することはできません。
📘ネストされた子
子を許可するブロックの場合、1 回のリクエストで最大 2 レベルのネストが許可されます。
📘統合機能
このエンドポイントには、コンテンツ挿入機能を持つ統合が必要です。コンテンツ挿入機能なしでこの API を呼び出そうとすると、403 ステータス コードを含む HTTP 応答が返されます。統合機 能の詳細については、機能ガイドを参照してください。
エラー
idで指定されたブロックが存在しない場合、または統合がブロックにアクセスできない場合は、404 HTTP 応答を返します。Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request PATCH 'https://api.notion.com/v1/blocks//children' \
--header 'Notion-Version;' \
--header 'Content-Type: application/json' \
--data-raw '{
"children": [
{
"heading_2": {
"text": [
{
"text": {
"content": "Lacinato kale"
},
"type": "text"
}
]
},
"object": "block",
"type": "heading_2"
},
{
"object": "block",
"paragraph": {
"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"
}
},
"type": "text"
}
]
},
"type": "paragraph"
}
]
}'Response Response Example
{
"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パラメータ
block_id
string
必須
Headerパラメータ
Notion-Version
string
必須
Request Bodyパラメータapplication/json
Response
更新日時 2023-04-28 08:46:11