Skip to main content
FuseFuse
IntegrationsNotionActions

List Notion block children

List direct children of a Notion block or page for recursive content reads.

Agent markdown

blocks.children.list · Notion · v1

Details

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

Scopes

  • read_content

Input

Input schema
NameTypeRequiredConstraints
(root)objectYesadditionalProperties false
block_idstringYesminLength 1; maxLength 64
start_cursorstringNominLength 1; maxLength 512
page_sizeintegerNominimum 1; maximum 100

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_childrenbooleanYes
results[].in_trashbooleanNo
results[].created_atstringNominLength 1; maxLength 64
results[].updated_atstringNominLength 1; maxLength 64
results[].plain_textstringNomaxLength 4096
results[].urlstringNomaxLength 2048
results[].checkedbooleanNo
results[].languagestringNomaxLength 64
results[].child_page_titlestringNomaxLength 2000
results[].child_data_source_titlestringNomaxLength 2000
results[].table_cellsarray<string>NomaxItems 100
results[].table_cells[]stringYesmaxLength 2000
results[].captionstringNomaxLength 2000
results[].synced_from_block_idstringNominLength 1; maxLength 64
results[].meeting_notes_summary_block_idstringNominLength 1; maxLength 64
results[].meeting_notes_notes_block_idstringNominLength 1; maxLength 64
results[].meeting_notes_transcript_block_idstringNominLength 1; maxLength 64
results[].meeting_notes_statusstringNomaxLength 64
next_cursorstringNominLength 1; maxLength 512
has_morebooleanNo

Raw schema

Input
{
  "type": "object",
  "additionalProperties": false,
  "properties": {
    "block_id": {
      "type": "string",
      "minLength": 1,
      "maxLength": 64
    },
    "start_cursor": {
      "type": "string",
      "minLength": 1,
      "maxLength": 512
    },
    "page_size": {
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    }
  },
  "required": [
    "block_id"
  ]
}
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"
          },
          "in_trash": {
            "type": "boolean"
          },
          "created_at": {
            "type": "string",
            "minLength": 1,
            "maxLength": 64
          },
          "updated_at": {
            "type": "string",
            "minLength": 1,
            "maxLength": 64
          },
          "plain_text": {
            "type": "string",
            "maxLength": 4096
          },
          "url": {
            "type": "string",
            "maxLength": 2048
          },
          "checked": {
            "type": "boolean"
          },
          "language": {
            "type": "string",
            "maxLength": 64
          },
          "child_page_title": {
            "type": "string",
            "maxLength": 2000
          },
          "child_data_source_title": {
            "type": "string",
            "maxLength": 2000
          },
          "table_cells": {
            "type": "array",
            "items": {
              "type": "string",
              "maxLength": 2000
            },
            "maxItems": 100
          },
          "caption": {
            "type": "string",
            "maxLength": 2000
          },
          "synced_from_block_id": {
            "type": "string",
            "minLength": 1,
            "maxLength": 64
          },
          "meeting_notes_summary_block_id": {
            "type": "string",
            "minLength": 1,
            "maxLength": 64
          },
          "meeting_notes_notes_block_id": {
            "type": "string",
            "minLength": 1,
            "maxLength": 64
          },
          "meeting_notes_transcript_block_id": {
            "type": "string",
            "minLength": 1,
            "maxLength": 64
          },
          "meeting_notes_status": {
            "type": "string",
            "maxLength": 64
          }
        },
        "required": [
          "id",
          "type",
          "has_children"
        ]
      },
      "maxItems": 100
    },
    "next_cursor": {
      "type": "string",
      "minLength": 1,
      "maxLength": 512
    },
    "has_more": {
      "type": "boolean"
    }
  },
  "required": [
    "results"
  ]
}