NotionNotion collaborative workspace API
PATCH/v1/blocks/{block_id}/children
Append block children
Appends new child blocks to the end of a block's children.
Manage pages, blocks, data sources/databases, comments, file uploads, views, users, and search through the official versioned Notion API, with OAuth and async tasks. The complete boundary is the 49 endpoints in the official OpenAPI snapshot; workspace data is private user content, so Pontx does not proxy, cache, or aggregate it and callers use the local SDK/CLI directly.
Request
- operationId
patchBlockChildren- Server
https://api.notion.com- Authentication
- bearerAuth, basicAuth
Request parameters
block_id
pathidRequestrequired
Notion-Version
headerstringrequired
API version date for the request; the current latest version is 2026-03-11.
2026-03-11
Request body
objectrequired
Properties: childrenposition
Responses
200
objectapplication/json
Request succeeded.
Properties: blockhas_morenext_cursorobjectresultstype
400
error_api_400application/json
Request parameters are invalid.
401
error_api_401application/json
Unauthenticated or the token is invalid.
403
error_api_403application/json
Access to the resource is forbidden.
404
error_api_404application/json
The requested resource was not found.
406
error_api_406application/json
The request cannot be represented as requested.
409
error_api_409application/json
The request conflicts with the current state of the resource.
429
error_api_429application/json
Rate limited; retry after Retry-After.
500
error_api_500application/json
Upstream internal error.
503
error_api_503application/json
Upstream service temporarily unavailable.
504
error_api_504application/json
Upstream gateway timeout.
529
error_api_529application/json
Upstream overloaded; retry like a 429.
{
"block": {},
"has_more": true,
"next_cursor": "example content",
"object": "list",
"results": [],
"type": "block"
}