Skip to content

Notion: Append block children

Notion blocks.patchBlockChildren: arguments, response, policy and SDK examples.

← Blocks operations · Get started

Operation notion.patch_block_children

Provider route: PATCH /v1/blocks/{block_id}/children. Alter supplies the connection’s credentials and routing.

Install @alter-ai/sdk @alter-ai/notion with npm, or alter-sdk-notion with pip. Supply your connected customer’s grant ID and the arguments described below.

import { App } from "@alter-ai/sdk";
import { NotionIntegration } from "@alter-ai/notion";
async function execute(input: Parameters<NotionIntegration["blocks"]["patchBlockChildren"]>[0]) {
const app = new App({ apiKey: process.env.ALTER_API_KEY! });
try {
const provider = new NotionIntegration(app, { grantId: process.env.PROVIDER_GRANT_ID! });
const call = await provider.blocks.patchBlockChildren(input);
const result = await call.wait();
return result.bodyJson();
} finally {
await app.close();
}
}
import os
from alter_sdk import App
from alter_sdk_notion import NotionIntegration
async def execute(arguments):
async with App(api_key=os.environ["ALTER_API_KEY"]) as app:
provider = NotionIntegration(app, {"grant_id": os.environ["PROVIDER_GRANT_ID"]})
call = await provider.blocks.patch_block_children(arguments)
result = await call.wait()
return result.body_json()
FieldTypePresenceDescription and constraints
$objectRootAdditional keys: not allowed
pathobjectRequired within parentAdditional keys: not allowed
path.block_idstringRequired within parent
bodyobjectRequired within parentAdditional keys: not allowed
body.childrenarrayRequired within parentMaximum items: 100
body.children[]ModelEach itemExpand Create a page — request body — body content item
body.notificationsModelOptionalExpand Update page — request body — body notifications
body.positionModelOptionalExpand Append block children — request body — body position

Referenced models: Create a page — request body — body content item, Append block children — request body — body position, Update page — request body — body notifications

Response media type: application/json. The table describes the pinned successful response. Referenced models link to their complete fields.

FieldTypePresenceDescription and constraints
$objectRoot
blockModelRequired within parentExpand List views — response body — view
has_morebooleanRequired within parent
next_cursorJSONRequired within parent
next_cursor (anyOf 1)stringAlternative
next_cursor (anyOf 2)nullAlternative
objectstringRequired within parentMust equal: list
resultsarrayRequired within parent
results[]JSONEach item
results[] (anyOf 1)ModelAlternativeExpand Delete a block — response body — object block
results[] (anyOf 2)ModelAlternativeExpand Delete a block — response body — value
typestringRequired within parentMust equal: block

Referenced models: List views — response body — view, Delete a block — response body — value, Delete a block — response body — object block

141 more schemas are linked from the tables above, on the schema pages.

List views — response body — view
FieldTypePresenceDescription and constraints
$objectRootAdditional keys: allowed
Delete a block — response body — value
FieldTypePresenceDescription and constraints
$JSONRoot
$ (anyOf 1)ModelAlternativeExpand Delete a block — response body — value Paragraph
$ (anyOf 2)ModelAlternativeExpand Delete a block — response body — value Heading 1
$ (anyOf 3)ModelAlternativeExpand Delete a block — response body — value Heading 2
$ (anyOf 4)ModelAlternativeExpand Delete a block — response body — value Heading 3
$ (anyOf 5)ModelAlternativeExpand Delete a block — response body — value Heading 4
$ (anyOf 6)ModelAlternativeExpand Delete a block — response body — value Bulleted List Item
$ (anyOf 7)ModelAlternativeExpand Delete a block — response body — value Numbered List Item
$ (anyOf 8)ModelAlternativeExpand Delete a block — response body — value Quote
$ (anyOf 9)ModelAlternativeExpand Delete a block — response body — value To Do
$ (anyOf 10)ModelAlternativeExpand Delete a block — response body — value Toggle
$ (anyOf 11)ModelAlternativeExpand Delete a block — response body — value Template
$ (anyOf 12)ModelAlternativeExpand Delete a block — response body — value Synced Block
$ (anyOf 13)ModelAlternativeExpand Delete a block — response body — value Child Page
$ (anyOf 14)ModelAlternativeExpand Delete a block — response body — value Child Database
$ (anyOf 15)ModelAlternativeExpand Delete a block — response body — value Equation
$ (anyOf 16)ModelAlternativeExpand Delete a block — response body — value Code
$ (anyOf 17)ModelAlternativeExpand Delete a block — response body — value Callout
$ (anyOf 18)ModelAlternativeExpand Delete a block — response body — value Divider
$ (anyOf 19)ModelAlternativeExpand Delete a block — response body — value Breadcrumb
$ (anyOf 20)ModelAlternativeExpand Delete a block — response body — value Table Of Contents
$ (anyOf 21)ModelAlternativeExpand Delete a block — response body — value Tab
$ (anyOf 22)ModelAlternativeExpand Delete a block — response body — value Column List
$ (anyOf 23)ModelAlternativeExpand Delete a block — response body — value Column
$ (anyOf 24)ModelAlternativeExpand Delete a block — response body — value Link To Page
$ (anyOf 25)ModelAlternativeExpand Delete a block — response body — value Table
$ (anyOf 26)ModelAlternativeExpand Delete a block — response body — value Table Row
$ (anyOf 27)ModelAlternativeExpand Delete a block — response body — value Meeting Notes
$ (anyOf 28)ModelAlternativeExpand Delete a block — response body — value Embed
$ (anyOf 29)ModelAlternativeExpand Delete a block — response body — value Bookmark
$ (anyOf 30)ModelAlternativeExpand Delete a block — response body — value Image
$ (anyOf 31)ModelAlternativeExpand Delete a block — response body — value Video
$ (anyOf 32)ModelAlternativeExpand Delete a block — response body — value Pdf
$ (anyOf 33)ModelAlternativeExpand Delete a block — response body — value File
$ (anyOf 34)ModelAlternativeExpand Delete a block — response body — value Audio
$ (anyOf 35)ModelAlternativeExpand Delete a block — response body — value Link Preview
$ (anyOf 36)ModelAlternativeExpand Delete a block — response body — value Unsupported

Referenced models: Delete a block — response body — value Audio, Delete a block — response body — value Bookmark, Delete a block — response body — value Breadcrumb, Delete a block — response body — value Bulleted List Item, Delete a block — response body — value Callout, Delete a block — response body — value Child Database, Delete a block — response body — value Child Page, Delete a block — response body — value Code, Delete a block — response body — value Column, Delete a block — response body — value Column List, Delete a block — response body — value Divider, Delete a block — response body — value Embed, Delete a block — response body — value Equation, Delete a block — response body — value File, Delete a block — response body — value Heading 1, Delete a block — response body — value Heading 2, Delete a block — response body — value Heading 3, Delete a block — response body — value Heading 4, Delete a block — response body — value Image, Delete a block — response body — value Link Preview, Delete a block — response body — value Link To Page, Delete a block — response body — value Meeting Notes, Delete a block — response body — value Numbered List Item, Delete a block — response body — value Paragraph, Delete a block — response body — value Pdf, Delete a block — response body — value Quote, Delete a block — response body — value Synced Block, Delete a block — response body — value Tab, Delete a block — response body — value Table, Delete a block — response body — value Table Of Contents, Delete a block — response body — value Table Row, Delete a block — response body — value Template, Delete a block — response body — value To Do, Delete a block — response body — value Toggle, Delete a block — response body — value Unsupported, Delete a block — response body — value Video

Delete a block — response body — object block
FieldTypePresenceDescription and constraints
$objectRoot
idstringRequired within parentFormat: uuid
objectstringRequired within parentMust equal: block
Update a block — request body — body value type tab tab
FieldTypePresenceDescription and constraints
$objectRootAdditional keys: not allowed

SDK function policy ID: notion.patch_block_children. Catalog operation: patch_block_children. Rules can name either ID; function rules distinguish managed calls and conservatively cover raw calls sharing the route. Existing grant permissions and policy rules apply. wait() returns an immediate result or waits for a required approval; it never approves the request itself. Persist the approval ID to resume after a restart.

Provider errors retain their response; JSON decoding raises ProviderAPIError for provider failures. ManagedOperationError identifies contract/input/retention errors. See error handling and provider-specific behavior. Sensitive input may be refused before approval storage. A decoding error never resubmits a write.

Pinned headers: {"Notion-Version": "2026-03-11"}

Official provider source

Report an issue with this page

Necessary

Required for sign-in, security, authorization, and remembering your choices.

Always active

Analytics

Helps us understand which product and documentation features are useful.

Performance diagnostics

Uses performance tracing and privacy-masked session replay to diagnose problems.

You can change these choices at any time from Cookie settings.