Creates and appends new children blocks to the parent block_id specified.

Returns a paginated list of newly created first level children block objects.

📘

Blocks cannot be moved

Blocks are appended to the bottom of the parent block. Once a block is appended as a child, it can't be moved elsewhere via the API.

📘

Nested Children

For blocks that allow children, we allow up to two levels of nesting in a single request.

📘

Integration capabilities

This endpoint requires an integration to have insert content capabilities. Attempting to call this API without insert content capabilities will return an HTTP response with a 403 status code. For more information on integration capabilities, see the capabilities guide.

Errors

Returns a 404 HTTP response if the block specified by id doesn't exist, or if the integration doesn't have access to the block.

Returns a 400 or 429 HTTP response if the request exceeds the request limits.

Language