PATCH /v1/blocks/{block_id}/children

Append block children

Servers

Path parameters

Name Type Required Description
block_id String Yes

Identifier for a block. Also accepts a page ID.

Request headers

Name Type Required Description
Content-Type String Yes The media type of the request body.

Default value: "application/json"

Request body fields

Name Type Required Description
after String No

The ID of the existing block that the new block should be appended after.

children[] Array Yes

Child content to append to a container block as an array of block objects

children[].type String No

Valid values:

  • "bulleted_list_item"
  • "paragraph"
children[].paragraph Object No
children[].paragraph.rich_text[] Array Yes
children[].paragraph.rich_text[].text Object Yes
children[].paragraph.rich_text[].text.content String Yes
children[].paragraph.rich_text[].text.link Object No
children[].paragraph.rich_text[].text.link.url String Yes
children[].paragraph.rich_text[].type String No

Valid values:

  • "text"
children[].bulleted_list_item Object No
children[].bulleted_list_item.rich_text[] Array Yes
children[].bulleted_list_item.rich_text[].text Object Yes
children[].bulleted_list_item.rich_text[].text.content String Yes
children[].bulleted_list_item.rich_text[].text.link Object No
children[].bulleted_list_item.rich_text[].text.link.url String Yes
children[].bulleted_list_item.rich_text[].type String No

Valid values:

  • "text"

How to start integrating

  1. Add HTTP Task to your workflow definition.
  2. Search for the API you want to integrate with and click on the name.
    • This loads the API reference documentation and prepares the Http request settings.
  3. Click Test request to test run your request to the API and see the API's response.