Skip to main content
FuseFuse
IntegrationsNotionActions

Append Notion block children

Append strict text blocks under a Notion block or page parent.

Agent markdown

blocks.children.append · Notion · v1

Details

Risk
Write
Idempotency
Unsafe
Availability
Default
Exposure
REST, SDK, MCP
MCP hints
readOnly=false, destructive=false, idempotent=false, openWorld=true

Scopes

  • insert_content

Input

Input schema
NameTypeRequiredConstraints
(root)objectYesadditionalProperties false
block_idstringYesminLength 1; maxLength 64
childrenarray<object>YesminItems 1; maxItems 100
children[]objectYesadditionalProperties false
children[].typestringYesenum paragraph | heading_1 | heading_2 | heading_3 | bulleted_list_item | numbered_list_item | to_do | quote | toggle
children[].rich_textarray<object>YesmaxItems 100
children[].rich_text[]objectYesadditionalProperties false
children[].rich_text[].typestringYesenum text
children[].rich_text[].textobjectYesadditionalProperties false
children[].rich_text[].text.contentstringYesminLength 1; maxLength 2000
children[].rich_text[].text.linkobjectNoadditionalProperties false
children[].rich_text[].text.link.urlstringYesminLength 8; maxLength 2048; pattern ^https://; format uri
children[].rich_text[].annotationsobjectNoadditionalProperties false
children[].rich_text[].annotations.boldbooleanNo
children[].rich_text[].annotations.italicbooleanNo
children[].rich_text[].annotations.strikethroughbooleanNo
children[].rich_text[].annotations.underlinebooleanNo
children[].rich_text[].annotations.codebooleanNo
children[].checkedbooleanNo
positionobjectNoadditionalProperties false
position.typestringYesenum start | end | after_block
position.after_blockobjectNoadditionalProperties false
position.after_block.idstringYesminLength 1; maxLength 64

Output

Output schema
NameTypeRequiredConstraints
(root)objectYesadditionalProperties false
resultsarray<object>YesmaxItems 100
results[]objectYesadditionalProperties false
results[].idstringYesminLength 1; maxLength 64
results[].typestringYesminLength 1; maxLength 64
results[].has_childrenbooleanNo
next_cursorstringNominLength 1; maxLength 512
has_morebooleanNo

Raw schema

Input
{
  "type": "object",
  "additionalProperties": false,
  "properties": {
    "block_id": {
      "type": "string",
      "minLength": 1,
      "maxLength": 64
    },
    "children": {
      "type": "array",
      "items": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "type": {
            "type": "string",
            "enum": [
              "paragraph",
              "heading_1",
              "heading_2",
              "heading_3",
              "bulleted_list_item",
              "numbered_list_item",
              "to_do",
              "quote",
              "toggle"
            ]
          },
          "rich_text": {
            "type": "array",
            "items": {
              "type": "object",
              "additionalProperties": false,
              "properties": {
                "type": {
                  "type": "string",
                  "enum": [
                    "text"
                  ]
                },
                "text": {
                  "type": "object",
                  "additionalProperties": false,
                  "properties": {
                    "content": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 2000
                    },
                    "link": {
                      "type": "object",
                      "additionalProperties": false,
                      "properties": {
                        "url": {
                          "type": "string",
                          "minLength": 8,
                          "maxLength": 2048,
                          "pattern": "^https://",
                          "format": "uri"
                        }
                      },
                      "required": [
                        "url"
                      ]
                    }
                  },
                  "required": [
                    "content"
                  ]
                },
                "annotations": {
                  "type": "object",
                  "additionalProperties": false,
                  "properties": {
                    "bold": {
                      "type": "boolean"
                    },
                    "italic": {
                      "type": "boolean"
                    },
                    "strikethrough": {
                      "type": "boolean"
                    },
                    "underline": {
                      "type": "boolean"
                    },
                    "code": {
                      "type": "boolean"
                    }
                  }
                }
              },
              "required": [
                "type",
                "text"
              ]
            },
            "maxItems": 100
          },
          "checked": {
            "type": "boolean"
          }
        },
        "required": [
          "type",
          "rich_text"
        ]
      },
      "minItems": 1,
      "maxItems": 100
    },
    "position": {
      "type": "object",
      "additionalProperties": false,
      "properties": {
        "type": {
          "type": "string",
          "enum": [
            "start",
            "end",
            "after_block"
          ]
        },
        "after_block": {
          "type": "object",
          "additionalProperties": false,
          "properties": {
            "id": {
              "type": "string",
              "minLength": 1,
              "maxLength": 64
            }
          },
          "required": [
            "id"
          ]
        }
      },
      "required": [
        "type"
      ]
    }
  },
  "required": [
    "block_id",
    "children"
  ]
}
Output
{
  "type": "object",
  "additionalProperties": false,
  "properties": {
    "results": {
      "type": "array",
      "items": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "id": {
            "type": "string",
            "minLength": 1,
            "maxLength": 64
          },
          "type": {
            "type": "string",
            "minLength": 1,
            "maxLength": 64
          },
          "has_children": {
            "type": "boolean"
          }
        },
        "required": [
          "id",
          "type"
        ]
      },
      "maxItems": 100
    },
    "next_cursor": {
      "type": "string",
      "minLength": 1,
      "maxLength": 512
    },
    "has_more": {
      "type": "boolean"
    }
  },
  "required": [
    "results"
  ]
}