--- title: "Retrieve block children" method: GET path: "/v1/blocks/{block_id}/children" tags: ["Blocks"] --- # Retrieve block children `GET /v1/blocks/{block_id}/children` ## Path parameters - `block_id` string, required ## Query parameters - `start_cursor` string, uuid - `page_size` number ## Headers - `Notion-Version` '2026-03-11', required ## Response `200` - object - `type` 'block', required - `block` EmptyObject, required - `object` 'list', required - `next_cursor` string, nullable, required - `has_more` boolean, required - `results` union[], required - union - PartialBlockObjectResponse - `object` 'block', required - `id` string, uuid, required - union - ParagraphBlockObjectResponse - `type` 'paragraph', required - `paragraph` ContentWithRichTextColorAndIconResponse, required - `rich_text` RichTextItemResponse[], required - … - `color` 'default' | 'gray' | 'brown' | 'orange' | 'yellow' | 'green' | 'blue' | 'purple' | 'pink' | 'red' | 'default_background' | 'gray_background' | 'brown_background' | 'orange_background' | 'yellow_background' | 'green_background' | 'blue_background' | 'purple_background' | 'pink_background' | 'red_background', required — One of: `default`, `gray`, `brown`, `orange`, `yellow`, `green`, `blue`, `purple`, `pink`, `red`, `default_background`, `gray_background`, `brown_background`, `orange_background`, `yellow_background`, `green_background`, `blue_background`, `purple_background`, `pink_background`, `red_background` - `icon` union, required - … - `parent` union, required - DatabaseParentResponse - … - DataSourceParentResponse - … - PageIdParentForBlockBasedObjectResponse - … - BlockIdParentForBlockBasedObjectResponse - … - AgentIdParentForBlockBasedObjectResponse - … - WorkspaceParentForBlockBasedObjectResponse - … - `object` 'block', required - `id` string, uuid, required - `created_time` string, date-time, required - `created_by` PartialUserObjectResponse, required - `id` string, uuid, required - `object` 'user', required — Always `user` - `last_edited_time` string, date-time, required - `last_edited_by` PartialUserObjectResponse, required - `id` string, uuid, required - `object` 'user', required — Always `user` - `has_children` boolean, required - `in_trash` boolean, required - Heading1BlockObjectResponse - `type` 'heading_1', required - `heading_1` HeaderContentWithRichTextAndColorResponse, required - `rich_text` RichTextItemResponse[], required - … - `color` 'default' | 'gray' | 'brown' | 'orange' | 'yellow' | 'green' | 'blue' | 'purple' | 'pink' | 'red' | 'default_background' | 'gray_background' | 'brown_background' | 'orange_background' | 'yellow_background' | 'green_background' | 'blue_background' | 'purple_background' | 'pink_background' | 'red_background', required — One of: `default`, `gray`, `brown`, `orange`, `yellow`, `green`, `blue`, `purple`, `pink`, `red`, `default_background`, `gray_background`, `brown_background`, `orange_background`, `yellow_background`, `green_background`, `blue_background`, `purple_background`, `pink_background`, `red_background` - `is_toggleable` boolean, required - `parent` union, required - DatabaseParentResponse - … - DataSourceParentResponse - … - PageIdParentForBlockBasedObjectResponse - … - BlockIdParentForBlockBasedObjectResponse - … - AgentIdParentForBlockBasedObjectResponse - … - WorkspaceParentForBlockBasedObjectResponse - … - `object` 'block', required - `id` string, uuid, required - `created_time` string, date-time, required - `created_by` PartialUserObjectResponse, required - `id` string, uuid, required - `object` 'user', required — Always `user` - `last_edited_time` string, date-time, required - `last_edited_by` PartialUserObjectResponse, required - `id` string, uuid, required - `object` 'user', required — Always `user` - `has_children` boolean, required - `in_trash` boolean, required - Heading2BlockObjectResponse - `type` 'heading_2', required - `heading_2` HeaderContentWithRichTextAndColorResponse, required - `rich_text` RichTextItemResponse[], required - … - `color` 'default' | 'gray' | 'brown' | 'orange' | 'yellow' | 'green' | 'blue' | 'purple' | 'pink' | 'red' | 'default_background' | 'gray_background' | 'brown_background' | 'orange_background' | 'yellow_background' | 'green_background' | 'blue_background' | 'purple_background' | 'pink_background' | 'red_background', required — One of: `default`, `gray`, `brown`, `orange`, `yellow`, `green`, `blue`, `purple`, `pink`, `red`, `default_background`, `gray_background`, `brown_background`, `orange_background`, `yellow_background`, `green_background`, `blue_background`, `purple_background`, `pink_background`, `red_background` - `is_toggleable` boolean, required - `parent` union, required - DatabaseParentResponse - … - DataSourceParentResponse - … - PageIdParentForBlockBasedObjectResponse - … - BlockIdParentForBlockBasedObjectResponse - … - AgentIdParentForBlockBasedObjectResponse - … - WorkspaceParentForBlockBasedObjectResponse - … - `object` 'block', required - `id` string, uuid, required - `created_time` string, date-time, required - `created_by` PartialUserObjectResponse, required - `id` string, uuid, required - `object` 'user', required — Always `user` - `last_edited_time` string, date-time, required - `last_edited_by` PartialUserObjectResponse, required - `id` string, uuid, required - `object` 'user', required — Always `user` - `has_children` boolean, required - `in_trash` boolean, required - Heading3BlockObjectResponse - `type` 'heading_3', required - `heading_3` HeaderContentWithRichTextAndColorResponse, required - `rich_text` RichTextItemResponse[], required - … - `color` 'default' | 'gray' | 'brown' | 'orange' | 'yellow' | 'green' | 'blue' | 'purple' | 'pink' | 'red' | 'default_background' | 'gray_background' | 'brown_background' | 'orange_background' | 'yellow_background' | 'green_background' | 'blue_background' | 'purple_background' | 'pink_background' | 'red_background', required — One of: `default`, `gray`, `brown`, `orange`, `yellow`, `green`, `blue`, `purple`, `pink`, `red`, `default_background`, `gray_background`, `brown_background`, `orange_background`, `yellow_background`, `green_background`, `blue_background`, `purple_background`, `pink_background`, `red_background` - `is_toggleable` boolean, required - `parent` union, required - DatabaseParentResponse - … - DataSourceParentResponse - … - PageIdParentForBlockBasedObjectResponse - … - BlockIdParentForBlockBasedObjectResponse - … - AgentIdParentForBlockBasedObjectResponse - … - WorkspaceParentForBlockBasedObjectResponse - … - `object` 'block', required - `id` string, uuid, required - `created_time` string, date-time, required - `created_by` PartialUserObjectResponse, required - `id` string, uuid, required - `object` 'user', required — Always `user` - `last_edited_time` string, date-time, required - `last_edited_by` PartialUserObjectResponse, required - `id` string, uuid, required - `object` 'user', required — Always `user` - `has_children` boolean, required - `in_trash` boolean, required - Heading4BlockObjectResponse - `type` 'heading_4', required - `heading_4` HeaderContentWithRichTextAndColorResponse, required - `rich_text` RichTextItemResponse[], required - … - `color` 'default' | 'gray' | 'brown' | 'orange' | 'yellow' | 'green' | 'blue' | 'purple' | 'pink' | 'red' | 'default_background' | 'gray_background' | 'brown_background' | 'orange_background' | 'yellow_background' | 'green_background' | 'blue_background' | 'purple_background' | 'pink_background' | 'red_background', required — One of: `default`, `gray`, `brown`, `orange`, `yellow`, `green`, `blue`, `purple`, `pink`, `red`, `default_background`, `gray_background`, `brown_background`, `orange_background`, `yellow_background`, `green_background`, `blue_background`, `purple_background`, `pink_background`, `red_background` - `is_toggleable` boolean, required - `parent` union, required - DatabaseParentResponse - … - DataSourceParentResponse - … - PageIdParentForBlockBasedObjectResponse - … - BlockIdParentForBlockBasedObjectResponse - … - AgentIdParentForBlockBasedObjectResponse - … - WorkspaceParentForBlockBasedObjectResponse - … - `object` 'block', required - `id` string, uuid, required - `created_time` string, date-time, required - `created_by` PartialUserObjectResponse, required - `id` string, uuid, required - `object` 'user', required — Always `user` - `last_edited_time` string, date-time, required - `last_edited_by` PartialUserObjectResponse, required - `id` string, uuid, required - `object` 'user', required — Always `user` - `has_children` boolean, required - `in_trash` boolean, required - BulletedListItemBlockObjectResponse - `type` 'bulleted_list_item', required - `bulleted_list_item` ContentWithRichTextAndColorResponse, required - `rich_text` RichTextItemResponse[], required - … - `color` 'default' | 'gray' | 'brown' | 'orange' | 'yellow' | 'green' | 'blue' | 'purple' | 'pink' | 'red' | 'default_background' | 'gray_background' | 'brown_background' | 'orange_background' | 'yellow_background' | 'green_background' | 'blue_background' | 'purple_background' | 'pink_background' | 'red_background', required — One of: `default`, `gray`, `brown`, `orange`, `yellow`, `green`, `blue`, `purple`, `pink`, `red`, `default_background`, `gray_background`, `brown_background`, `orange_background`, `yellow_background`, `green_background`, `blue_background`, `purple_background`, `pink_background`, `red_background` - `parent` union, required - DatabaseParentResponse - … - DataSourceParentResponse - … - PageIdParentForBlockBasedObjectResponse - … - BlockIdParentForBlockBasedObjectResponse - … - AgentIdParentForBlockBasedObjectResponse - … - WorkspaceParentForBlockBasedObjectResponse - … - `object` 'block', required - `id` string, uuid, required - `created_time` string, date-time, required - `created_by` PartialUserObjectResponse, required - `id` string, uuid, required - `object` 'user', required — Always `user` - `last_edited_time` string, date-time, required - `last_edited_by` PartialUserObjectResponse, required - `id` string, uuid, required - `object` 'user', required — Always `user` - `has_children` boolean, required - `in_trash` boolean, required - NumberedListItemBlockObjectResponse - `type` 'numbered_list_item', required - `numbered_list_item` ContentWithRichTextAndColorAndListResponse, required - `rich_text` RichTextItemResponse[], required - … - `color` 'default' | 'gray' | 'brown' | 'orange' | 'yellow' | 'green' | 'blue' | 'purple' | 'pink' | 'red' | 'default_background' | 'gray_background' | 'brown_background' | 'orange_background' | 'yellow_background' | 'green_background' | 'blue_background' | 'purple_background' | 'pink_background' | 'red_background', required — One of: `default`, `gray`, `brown`, `orange`, `yellow`, `green`, `blue`, `purple`, `pink`, `red`, `default_background`, `gray_background`, `brown_background`, `orange_background`, `yellow_background`, `green_background`, `blue_background`, `purple_background`, `pink_background`, `red_background` - `list_start_index` integer - `list_format` 'numbers' | 'letters' | 'roman' - `parent` union, required - DatabaseParentResponse - … - DataSourceParentResponse - … - PageIdParentForBlockBasedObjectResponse - … - BlockIdParentForBlockBasedObjectResponse - … - AgentIdParentForBlockBasedObjectResponse - … - WorkspaceParentForBlockBasedObjectResponse - … - `object` 'block', required - `id` string, uuid, required - `created_time` string, date-time, required - `created_by` PartialUserObjectResponse, required - `id` string, uuid, required - `object` 'user', required — Always `user` - `last_edited_time` string, date-time, required - `last_edited_by` PartialUserObjectResponse, required - `id` string, uuid, required - `object` 'user', required — Always `user` - `has_children` boolean, required - `in_trash` boolean, required - QuoteBlockObjectResponse - `type` 'quote', required - `quote` ContentWithRichTextAndColorResponse, required - `rich_text` RichTextItemResponse[], required - … - `color` 'default' | 'gray' | 'brown' | 'orange' | 'yellow' | 'green' | 'blue' | 'purple' | 'pink' | 'red' | 'default_background' | 'gray_background' | 'brown_background' | 'orange_background' | 'yellow_background' | 'green_background' | 'blue_background' | 'purple_background' | 'pink_background' | 'red_background', required — One of: `default`, `gray`, `brown`, `orange`, `yellow`, `green`, `blue`, `purple`, `pink`, `red`, `default_background`, `gray_background`, `brown_background`, `orange_background`, `yellow_background`, `green_background`, `blue_background`, `purple_background`, `pink_background`, `red_background` - `parent` union, required - DatabaseParentResponse - … - DataSourceParentResponse - … - PageIdParentForBlockBasedObjectResponse - … - BlockIdParentForBlockBasedObjectResponse - … - AgentIdParentForBlockBasedObjectResponse - … - WorkspaceParentForBlockBasedObjectResponse - … - `object` 'block', required - `id` string, uuid, required - `created_time` string, date-time, required - `created_by` PartialUserObjectResponse, required - `id` string, uuid, required - `object` 'user', required — Always `user` - `last_edited_time` string, date-time, required - `last_edited_by` PartialUserObjectResponse, required - `id` string, uuid, required - `object` 'user', required — Always `user` - `has_children` boolean, required - `in_trash` boolean, required - ToDoBlockObjectResponse - `type` 'to_do', required - `to_do` object, required - `rich_text` RichTextItemResponse[], required - … - `color` 'default' | 'gray' | 'brown' | 'orange' | 'yellow' | 'green' | 'blue' | 'purple' | 'pink' | 'red' | 'default_background' | 'gray_background' | 'brown_background' | 'orange_background' | 'yellow_background' | 'green_background' | 'blue_background' | 'purple_background' | 'pink_background' | 'red_background', required — One of: `default`, `gray`, `brown`, `orange`, `yellow`, `green`, `blue`, `purple`, `pink`, `red`, `default_background`, `gray_background`, `brown_background`, `orange_background`, `yellow_background`, `green_background`, `blue_background`, `purple_background`, `pink_background`, `red_background` - `checked` boolean, required - `parent` union, required - DatabaseParentResponse - … - DataSourceParentResponse - … - PageIdParentForBlockBasedObjectResponse - … - BlockIdParentForBlockBasedObjectResponse - … - AgentIdParentForBlockBasedObjectResponse - … - WorkspaceParentForBlockBasedObjectResponse - … - `object` 'block', required - `id` string, uuid, required - `created_time` string, date-time, required - `created_by` PartialUserObjectResponse, required - `id` string, uuid, required - `object` 'user', required — Always `user` - `last_edited_time` string, date-time, required - `last_edited_by` PartialUserObjectResponse, required - `id` string, uuid, required - `object` 'user', required — Always `user` - `has_children` boolean, required - `in_trash` boolean, required - ToggleBlockObjectResponse - `type` 'toggle', required - `toggle` ContentWithRichTextAndColorResponse, required - `rich_text` RichTextItemResponse[], required - … - `color` 'default' | 'gray' | 'brown' | 'orange' | 'yellow' | 'green' | 'blue' | 'purple' | 'pink' | 'red' | 'default_background' | 'gray_background' | 'brown_background' | 'orange_background' | 'yellow_background' | 'green_background' | 'blue_background' | 'purple_background' | 'pink_background' | 'red_background', required — One of: `default`, `gray`, `brown`, `orange`, `yellow`, `green`, `blue`, `purple`, `pink`, `red`, `default_background`, `gray_background`, `brown_background`, `orange_background`, `yellow_background`, `green_background`, `blue_background`, `purple_background`, `pink_background`, `red_background` - `parent` union, required - DatabaseParentResponse - … - DataSourceParentResponse - … - PageIdParentForBlockBasedObjectResponse - … - BlockIdParentForBlockBasedObjectResponse - … - AgentIdParentForBlockBasedObjectResponse - … - WorkspaceParentForBlockBasedObjectResponse - … - `object` 'block', required - `id` string, uuid, required - `created_time` string, date-time, required - `created_by` PartialUserObjectResponse, required - `id` string, uuid, required - `object` 'user', required — Always `user` - `last_edited_time` string, date-time, required - `last_edited_by` PartialUserObjectResponse, required - `id` string, uuid, required - `object` 'user', required — Always `user` - `has_children` boolean, required - `in_trash` boolean, required - TemplateBlockObjectResponse - `type` 'template', required - `template` object, required - `rich_text` RichTextItemResponse[], required - … - `parent` union, required - DatabaseParentResponse - … - DataSourceParentResponse - … - PageIdParentForBlockBasedObjectResponse - … - BlockIdParentForBlockBasedObjectResponse - … - AgentIdParentForBlockBasedObjectResponse - … - WorkspaceParentForBlockBasedObjectResponse - … - `object` 'block', required - `id` string, uuid, required - `created_time` string, date-time, required - `created_by` PartialUserObjectResponse, required - `id` string, uuid, required - `object` 'user', required — Always `user` - `last_edited_time` string, date-time, required - `last_edited_by` PartialUserObjectResponse, required - `id` string, uuid, required - `object` 'user', required — Always `user` - `has_children` boolean, required - `in_trash` boolean, required - SyncedBlockBlockObjectResponse - `type` 'synced_block', required - `synced_block` object, required - `synced_from` object, nullable, required - … - `parent` union, required - DatabaseParentResponse - … - DataSourceParentResponse - … - PageIdParentForBlockBasedObjectResponse - … - BlockIdParentForBlockBasedObjectResponse - … - AgentIdParentForBlockBasedObjectResponse - … - WorkspaceParentForBlockBasedObjectResponse - … - `object` 'block', required - `id` string, uuid, required - `created_time` string, date-time, required - `created_by` PartialUserObjectResponse, required - `id` string, uuid, required - `object` 'user', required — Always `user` - `last_edited_time` string, date-time, required - `last_edited_by` PartialUserObjectResponse, required - `id` string, uuid, required - `object` 'user', required — Always `user` - `has_children` boolean, required - `in_trash` boolean, required - ChildPageBlockObjectResponse - `type` 'child_page', required - `child_page` TitleObjectResponse, required - `title` string, required - `parent` union, required - DatabaseParentResponse - … - DataSourceParentResponse - … - PageIdParentForBlockBasedObjectResponse - … - BlockIdParentForBlockBasedObjectResponse - … - AgentIdParentForBlockBasedObjectResponse - … - WorkspaceParentForBlockBasedObjectResponse - … - `object` 'block', required - `id` string, uuid, required - `created_time` string, date-time, required - `created_by` PartialUserObjectResponse, required - `id` string, uuid, required - `object` 'user', required — Always `user` - `last_edited_time` string, date-time, required - `last_edited_by` PartialUserObjectResponse, required - `id` string, uuid, required - `object` 'user', required — Always `user` - `has_children` boolean, required - `in_trash` boolean, required - ChildDatabaseBlockObjectResponse - `type` 'child_database', required - `child_database` TitleObjectResponse, required - `title` string, required - `parent` union, required - DatabaseParentResponse - … - DataSourceParentResponse - … - PageIdParentForBlockBasedObjectResponse - … - BlockIdParentForBlockBasedObjectResponse - … - AgentIdParentForBlockBasedObjectResponse - … - WorkspaceParentForBlockBasedObjectResponse - … - `object` 'block', required - `id` string, uuid, required - `created_time` string, date-time, required - `created_by` PartialUserObjectResponse, required - `id` string, uuid, required - `object` 'user', required — Always `user` - `last_edited_time` string, date-time, required - `last_edited_by` PartialUserObjectResponse, required - `id` string, uuid, required - `object` 'user', required — Always `user` - `has_children` boolean, required - `in_trash` boolean, required - EquationBlockObjectResponse - `type` 'equation', required - `equation` ExpressionObjectResponse, required - `expression` string, required - `parent` union, required - DatabaseParentResponse - … - DataSourceParentResponse - … - PageIdParentForBlockBasedObjectResponse - … - BlockIdParentForBlockBasedObjectResponse - … - AgentIdParentForBlockBasedObjectResponse - … - WorkspaceParentForBlockBasedObjectResponse - … - `object` 'block', required - `id` string, uuid, required - `created_time` string, date-time, required - `created_by` PartialUserObjectResponse, required - `id` string, uuid, required - `object` 'user', required — Always `user` - `last_edited_time` string, date-time, required - `last_edited_by` PartialUserObjectResponse, required - `id` string, uuid, required - `object` 'user', required — Always `user` - `has_children` boolean, required - `in_trash` boolean, required - CodeBlockObjectResponse - `type` 'code', required - `code` object, required - `rich_text` RichTextItemResponse[], required - … - `caption` RichTextItemResponse[], required - … - `language` 'abap' | 'abc' | 'agda' | 'arduino' | 'ascii art' | 'assembly' | 'bash' | 'basic' | 'bnf' | 'c' | 'c#' | 'c++' | 'clojure' | 'coffeescript' | 'coq' | 'css' | 'dart' | 'dhall' | 'diff' | 'docker' | 'ebnf' | 'elixir' | 'elm' | 'erlang' | 'f#' | 'flow' | 'fortran' | 'gherkin' | 'glsl' | 'go' | 'graphql' | 'groovy' | 'haskell' | 'hcl' | 'html' | 'idris' | 'java' | 'javascript' | 'json' | 'julia' | 'kotlin' | 'latex' | 'less' | 'lisp' | 'livescript' | 'llvm ir' | 'lua' | 'makefile' | 'markdown' | 'markup' | 'matlab' | 'mathematica' | 'mermaid' | 'nix' | 'notion formula' | 'objective-c' | 'ocaml' | 'pascal' | 'perl' | 'php' | 'plain text' | 'powershell' | 'prolog' | 'protobuf' | 'purescript' | 'python' | 'r' | 'racket' | 'reason' | 'ruby' | 'rust' | 'sass' | 'scala' | 'scheme' | 'scss' | 'shell' | 'smalltalk' | 'solidity' | 'sql' | 'swift' | 'toml' | 'typescript' | 'vb.net' | 'verilog' | 'vhdl' | 'visual basic' | 'webassembly' | 'xml' | 'yaml' | 'java/c/c++/c#', required - `parent` union, required - DatabaseParentResponse - … - DataSourceParentResponse - … - PageIdParentForBlockBasedObjectResponse - … - BlockIdParentForBlockBasedObjectResponse - … - AgentIdParentForBlockBasedObjectResponse - … - WorkspaceParentForBlockBasedObjectResponse - … - `object` 'block', required - `id` string, uuid, required - `created_time` string, date-time, required - `created_by` PartialUserObjectResponse, required - `id` string, uuid, required - `object` 'user', required — Always `user` - `last_edited_time` string, date-time, required - `last_edited_by` PartialUserObjectResponse, required - `id` string, uuid, required - `object` 'user', required — Always `user` - `has_children` boolean, required - `in_trash` boolean, required - CalloutBlockObjectResponse - `type` 'callout', required - `callout` object, required - `rich_text` RichTextItemResponse[], required - … - `color` 'default' | 'gray' | 'brown' | 'orange' | 'yellow' | 'green' | 'blue' | 'purple' | 'pink' | 'red' | 'default_background' | 'gray_background' | 'brown_background' | 'orange_background' | 'yellow_background' | 'green_background' | 'blue_background' | 'purple_background' | 'pink_background' | 'red_background', required — One of: `default`, `gray`, `brown`, `orange`, `yellow`, `green`, `blue`, `purple`, `pink`, `red`, `default_background`, `gray_background`, `brown_background`, `orange_background`, `yellow_background`, `green_background`, `blue_background`, `purple_background`, `pink_background`, `red_background` - `icon` union, required - … - `parent` union, required - DatabaseParentResponse - … - DataSourceParentResponse - … - PageIdParentForBlockBasedObjectResponse - … - BlockIdParentForBlockBasedObjectResponse - … - AgentIdParentForBlockBasedObjectResponse - … - WorkspaceParentForBlockBasedObjectResponse - … - `object` 'block', required - `id` string, uuid, required - `created_time` string, date-time, required - `created_by` PartialUserObjectResponse, required - `id` string, uuid, required - `object` 'user', required — Always `user` - `last_edited_time` string, date-time, required - `last_edited_by` PartialUserObjectResponse, required - `id` string, uuid, required - `object` 'user', required — Always `user` - `has_children` boolean, required - `in_trash` boolean, required - DividerBlockObjectResponse - `type` 'divider', required - `divider` EmptyObject, required - `parent` union, required - DatabaseParentResponse - … - DataSourceParentResponse - … - PageIdParentForBlockBasedObjectResponse - … - BlockIdParentForBlockBasedObjectResponse - … - AgentIdParentForBlockBasedObjectResponse - … - WorkspaceParentForBlockBasedObjectResponse - … - `object` 'block', required - `id` string, uuid, required - `created_time` string, date-time, required - `created_by` PartialUserObjectResponse, required - `id` string, uuid, required - `object` 'user', required — Always `user` - `last_edited_time` string, date-time, required - `last_edited_by` PartialUserObjectResponse, required - `id` string, uuid, required - `object` 'user', required — Always `user` - `has_children` boolean, required - `in_trash` boolean, required - BreadcrumbBlockObjectResponse - `type` 'breadcrumb', required - `breadcrumb` EmptyObject, required - `parent` union, required - DatabaseParentResponse - … - DataSourceParentResponse - … - PageIdParentForBlockBasedObjectResponse - … - BlockIdParentForBlockBasedObjectResponse - … - AgentIdParentForBlockBasedObjectResponse - … - WorkspaceParentForBlockBasedObjectResponse - … - `object` 'block', required - `id` string, uuid, required - `created_time` string, date-time, required - `created_by` PartialUserObjectResponse, required - `id` string, uuid, required - `object` 'user', required — Always `user` - `last_edited_time` string, date-time, required - `last_edited_by` PartialUserObjectResponse, required - `id` string, uuid, required - `object` 'user', required — Always `user` - `has_children` boolean, required - `in_trash` boolean, required - TableOfContentsBlockObjectResponse - `type` 'table_of_contents', required - `table_of_contents` object, required - `color` 'default' | 'gray' | 'brown' | 'orange' | 'yellow' | 'green' | 'blue' | 'purple' | 'pink' | 'red' | 'default_background' | 'gray_background' | 'brown_background' | 'orange_background' | 'yellow_background' | 'green_background' | 'blue_background' | 'purple_background' | 'pink_background' | 'red_background', required — One of: `default`, `gray`, `brown`, `orange`, `yellow`, `green`, `blue`, `purple`, `pink`, `red`, `default_background`, `gray_background`, `brown_background`, `orange_background`, `yellow_background`, `green_background`, `blue_background`, `purple_background`, `pink_background`, `red_background` - `parent` union, required - DatabaseParentResponse - … - DataSourceParentResponse - … - PageIdParentForBlockBasedObjectResponse - … - BlockIdParentForBlockBasedObjectResponse - … - AgentIdParentForBlockBasedObjectResponse - … - WorkspaceParentForBlockBasedObjectResponse - … - `object` 'block', required - `id` string, uuid, required - `created_time` string, date-time, required - `created_by` PartialUserObjectResponse, required - `id` string, uuid, required - `object` 'user', required — Always `user` - `last_edited_time` string, date-time, required - `last_edited_by` PartialUserObjectResponse, required - `id` string, uuid, required - `object` 'user', required — Always `user` - `has_children` boolean, required - `in_trash` boolean, required - TabBlockObjectResponse - `type` 'tab', required - `tab` EmptyObject, required - `parent` union, required - DatabaseParentResponse - … - DataSourceParentResponse - … - PageIdParentForBlockBasedObjectResponse - … - BlockIdParentForBlockBasedObjectResponse - … - AgentIdParentForBlockBasedObjectResponse - … - WorkspaceParentForBlockBasedObjectResponse - … - `object` 'block', required - `id` string, uuid, required - `created_time` string, date-time, required - `created_by` PartialUserObjectResponse, required - `id` string, uuid, required - `object` 'user', required — Always `user` - `last_edited_time` string, date-time, required - `last_edited_by` PartialUserObjectResponse, required - `id` string, uuid, required - `object` 'user', required — Always `user` - `has_children` boolean, required - `in_trash` boolean, required - ColumnListBlockObjectResponse - `type` 'column_list', required - `column_list` EmptyObject, required - `parent` union, required - DatabaseParentResponse - … - DataSourceParentResponse - … - PageIdParentForBlockBasedObjectResponse - … - BlockIdParentForBlockBasedObjectResponse - … - AgentIdParentForBlockBasedObjectResponse - … - WorkspaceParentForBlockBasedObjectResponse - … - `object` 'block', required - `id` string, uuid, required - `created_time` string, date-time, required - `created_by` PartialUserObjectResponse, required - `id` string, uuid, required - `object` 'user', required — Always `user` - `last_edited_time` string, date-time, required - `last_edited_by` PartialUserObjectResponse, required - `id` string, uuid, required - `object` 'user', required — Always `user` - `has_children` boolean, required - `in_trash` boolean, required - ColumnBlockObjectResponse - `type` 'column', required - `column` ColumnResponse, required - `width_ratio` number — Ratio between 0 and 1 of the width of this column relative to all columns in the list. If not provided, uses an equal width. - `parent` union, required - DatabaseParentResponse - … - DataSourceParentResponse - … - PageIdParentForBlockBasedObjectResponse - … - BlockIdParentForBlockBasedObjectResponse - … - AgentIdParentForBlockBasedObjectResponse - … - WorkspaceParentForBlockBasedObjectResponse - … - `object` 'block', required - `id` string, uuid, required - `created_time` string, date-time, required - `created_by` PartialUserObjectResponse, required - `id` string, uuid, required - `object` 'user', required — Always `user` - `last_edited_time` string, date-time, required - `last_edited_by` PartialUserObjectResponse, required - `id` string, uuid, required - `object` 'user', required — Always `user` - `has_children` boolean, required - `in_trash` boolean, required - LinkToPageBlockObjectResponse - `type` 'link_to_page', required - `link_to_page` union, required - object - … - object - … - object - … - `parent` union, required - DatabaseParentResponse - … - DataSourceParentResponse - … - PageIdParentForBlockBasedObjectResponse - … - BlockIdParentForBlockBasedObjectResponse - … - AgentIdParentForBlockBasedObjectResponse - … - WorkspaceParentForBlockBasedObjectResponse - … - `object` 'block', required - `id` string, uuid, required - `created_time` string, date-time, required - `created_by` PartialUserObjectResponse, required - `id` string, uuid, required - `object` 'user', required — Always `user` - `last_edited_time` string, date-time, required - `last_edited_by` PartialUserObjectResponse, required - `id` string, uuid, required - `object` 'user', required — Always `user` - `has_children` boolean, required - `in_trash` boolean, required - TableBlockObjectResponse - `type` 'table', required - `table` ContentWithTableResponse, required - `has_column_header` boolean, required - `has_row_header` boolean, required - `table_width` integer, required - `parent` union, required - DatabaseParentResponse - … - DataSourceParentResponse - … - PageIdParentForBlockBasedObjectResponse - … - BlockIdParentForBlockBasedObjectResponse - … - AgentIdParentForBlockBasedObjectResponse - … - WorkspaceParentForBlockBasedObjectResponse - … - `object` 'block', required - `id` string, uuid, required - `created_time` string, date-time, required - `created_by` PartialUserObjectResponse, required - `id` string, uuid, required - `object` 'user', required — Always `user` - `last_edited_time` string, date-time, required - `last_edited_by` PartialUserObjectResponse, required - `id` string, uuid, required - `object` 'user', required — Always `user` - `has_children` boolean, required - `in_trash` boolean, required - TableRowBlockObjectResponse - `type` 'table_row', required - `table_row` ContentWithTableRowResponse, required - `cells` array[], required - … - `parent` union, required - DatabaseParentResponse - … - DataSourceParentResponse - … - PageIdParentForBlockBasedObjectResponse - … - BlockIdParentForBlockBasedObjectResponse - … - AgentIdParentForBlockBasedObjectResponse - … - WorkspaceParentForBlockBasedObjectResponse - … - `object` 'block', required - `id` string, uuid, required - `created_time` string, date-time, required - `created_by` PartialUserObjectResponse, required - `id` string, uuid, required - `object` 'user', required — Always `user` - `last_edited_time` string, date-time, required - `last_edited_by` PartialUserObjectResponse, required - `id` string, uuid, required - `object` 'user', required — Always `user` - `has_children` boolean, required - `in_trash` boolean, required - MeetingNotesBlockObjectResponse - `type` 'meeting_notes', required - `meeting_notes` TranscriptionBlockResponse, required - `title` RichTextItemResponse[] - … - `status` 'transcription_not_started' | 'transcription_paused' | 'transcription_in_progress' | 'transcription_failed' | 'summary_in_progress' | 'notes_ready' - `children` TranscriptionChildrenResponse - … - `calendar_event` TranscriptionCalendarEventResponse - … - `recording` TranscriptionRecordingResponse - … - `parent` union, required - DatabaseParentResponse - … - DataSourceParentResponse - … - PageIdParentForBlockBasedObjectResponse - … - BlockIdParentForBlockBasedObjectResponse - … - AgentIdParentForBlockBasedObjectResponse - … - WorkspaceParentForBlockBasedObjectResponse - … - `object` 'block', required - `id` string, uuid, required - `created_time` string, date-time, required - `created_by` PartialUserObjectResponse, required - `id` string, uuid, required - `object` 'user', required — Always `user` - `last_edited_time` string, date-time, required - `last_edited_by` PartialUserObjectResponse, required - `id` string, uuid, required - `object` 'user', required — Always `user` - `has_children` boolean, required - `in_trash` boolean, required - EmbedBlockObjectResponse - `type` 'embed', required - `embed` MediaContentWithUrlAndCaptionResponse, required - `url` string, required - `caption` RichTextItemResponse[], required - … - `parent` union, required - DatabaseParentResponse - … - DataSourceParentResponse - … - PageIdParentForBlockBasedObjectResponse - … - BlockIdParentForBlockBasedObjectResponse - … - AgentIdParentForBlockBasedObjectResponse - … - WorkspaceParentForBlockBasedObjectResponse - … - `object` 'block', required - `id` string, uuid, required - `created_time` string, date-time, required - `created_by` PartialUserObjectResponse, required - `id` string, uuid, required - `object` 'user', required — Always `user` - `last_edited_time` string, date-time, required - `last_edited_by` PartialUserObjectResponse, required - `id` string, uuid, required - `object` 'user', required — Always `user` - `has_children` boolean, required - `in_trash` boolean, required - BookmarkBlockObjectResponse - `type` 'bookmark', required - `bookmark` MediaContentWithUrlAndCaptionResponse, required - `url` string, required - `caption` RichTextItemResponse[], required - … - `parent` union, required - DatabaseParentResponse - … - DataSourceParentResponse - … - PageIdParentForBlockBasedObjectResponse - … - BlockIdParentForBlockBasedObjectResponse - … - AgentIdParentForBlockBasedObjectResponse - … - WorkspaceParentForBlockBasedObjectResponse - … - `object` 'block', required - `id` string, uuid, required - `created_time` string, date-time, required - `created_by` PartialUserObjectResponse, required - `id` string, uuid, required - `object` 'user', required — Always `user` - `last_edited_time` string, date-time, required - `last_edited_by` PartialUserObjectResponse, required - `id` string, uuid, required - `object` 'user', required — Always `user` - `has_children` boolean, required - `in_trash` boolean, required - ImageBlockObjectResponse - `type` 'image', required - `image` union, required - ExternalMediaContentWithFileAndCaptionResponse - … - FileMediaContentWithFileAndCaptionResponse - … - `parent` union, required - DatabaseParentResponse - … - DataSourceParentResponse - … - PageIdParentForBlockBasedObjectResponse - … - BlockIdParentForBlockBasedObjectResponse - … - AgentIdParentForBlockBasedObjectResponse - … - WorkspaceParentForBlockBasedObjectResponse - … - `object` 'block', required - `id` string, uuid, required - `created_time` string, date-time, required - `created_by` PartialUserObjectResponse, required - `id` string, uuid, required - `object` 'user', required — Always `user` - `last_edited_time` string, date-time, required - `last_edited_by` PartialUserObjectResponse, required - `id` string, uuid, required - `object` 'user', required — Always `user` - `has_children` boolean, required - `in_trash` boolean, required - VideoBlockObjectResponse - `type` 'video', required - `video` union, required - ExternalMediaContentWithFileAndCaptionResponse - … - FileMediaContentWithFileAndCaptionResponse - … - `parent` union, required - DatabaseParentResponse - … - DataSourceParentResponse - … - PageIdParentForBlockBasedObjectResponse - … - BlockIdParentForBlockBasedObjectResponse - … - AgentIdParentForBlockBasedObjectResponse - … - WorkspaceParentForBlockBasedObjectResponse - … - `object` 'block', required - `id` string, uuid, required - `created_time` string, date-time, required - `created_by` PartialUserObjectResponse, required - `id` string, uuid, required - `object` 'user', required — Always `user` - `last_edited_time` string, date-time, required - `last_edited_by` PartialUserObjectResponse, required - `id` string, uuid, required - `object` 'user', required — Always `user` - `has_children` boolean, required - `in_trash` boolean, required - PdfBlockObjectResponse - `type` 'pdf', required - `pdf` union, required - ExternalMediaContentWithFileAndCaptionResponse - … - FileMediaContentWithFileAndCaptionResponse - … - `parent` union, required - DatabaseParentResponse - … - DataSourceParentResponse - … - PageIdParentForBlockBasedObjectResponse - … - BlockIdParentForBlockBasedObjectResponse - … - AgentIdParentForBlockBasedObjectResponse - … - WorkspaceParentForBlockBasedObjectResponse - … - `object` 'block', required - `id` string, uuid, required - `created_time` string, date-time, required - `created_by` PartialUserObjectResponse, required - `id` string, uuid, required - `object` 'user', required — Always `user` - `last_edited_time` string, date-time, required - `last_edited_by` PartialUserObjectResponse, required - `id` string, uuid, required - `object` 'user', required — Always `user` - `has_children` boolean, required - `in_trash` boolean, required - FileBlockObjectResponse - `type` 'file', required - `file` union, required - ExternalMediaContentWithFileNameAndCaptionResponse - … - FileMediaContentWithFileNameAndCaptionResponse - … - `parent` union, required - DatabaseParentResponse - … - DataSourceParentResponse - … - PageIdParentForBlockBasedObjectResponse - … - BlockIdParentForBlockBasedObjectResponse - … - AgentIdParentForBlockBasedObjectResponse - … - WorkspaceParentForBlockBasedObjectResponse - … - `object` 'block', required - `id` string, uuid, required - `created_time` string, date-time, required - `created_by` PartialUserObjectResponse, required - `id` string, uuid, required - `object` 'user', required — Always `user` - `last_edited_time` string, date-time, required - `last_edited_by` PartialUserObjectResponse, required - `id` string, uuid, required - `object` 'user', required — Always `user` - `has_children` boolean, required - `in_trash` boolean, required - AudioBlockObjectResponse - `type` 'audio', required - `audio` union, required - ExternalMediaContentWithFileAndCaptionResponse - … - FileMediaContentWithFileAndCaptionResponse - … - `parent` union, required - DatabaseParentResponse - … - DataSourceParentResponse - … - PageIdParentForBlockBasedObjectResponse - … - BlockIdParentForBlockBasedObjectResponse - … - AgentIdParentForBlockBasedObjectResponse - … - WorkspaceParentForBlockBasedObjectResponse - … - `object` 'block', required - `id` string, uuid, required - `created_time` string, date-time, required - `created_by` PartialUserObjectResponse, required - `id` string, uuid, required - `object` 'user', required — Always `user` - `last_edited_time` string, date-time, required - `last_edited_by` PartialUserObjectResponse, required - `id` string, uuid, required - `object` 'user', required — Always `user` - `has_children` boolean, required - `in_trash` boolean, required - LinkPreviewBlockObjectResponse - `type` 'link_preview', required - `link_preview` MediaContentWithUrlResponse, required - `url` string, required - `parent` union, required - DatabaseParentResponse - … - DataSourceParentResponse - … - PageIdParentForBlockBasedObjectResponse - … - BlockIdParentForBlockBasedObjectResponse - … - AgentIdParentForBlockBasedObjectResponse - … - WorkspaceParentForBlockBasedObjectResponse - … - `object` 'block', required - `id` string, uuid, required - `created_time` string, date-time, required - `created_by` PartialUserObjectResponse, required - `id` string, uuid, required - `object` 'user', required — Always `user` - `last_edited_time` string, date-time, required - `last_edited_by` PartialUserObjectResponse, required - `id` string, uuid, required - `object` 'user', required — Always `user` - `has_children` boolean, required - `in_trash` boolean, required - UnsupportedBlockObjectResponse - `type` 'unsupported', required - `unsupported` object, required - `block_type` string, required — The underlying block type that is not currently supported by the Public API. Example values include: form, button, drive. - `parent` union, required - DatabaseParentResponse - … - DataSourceParentResponse - … - PageIdParentForBlockBasedObjectResponse - … - BlockIdParentForBlockBasedObjectResponse - … - AgentIdParentForBlockBasedObjectResponse - … - WorkspaceParentForBlockBasedObjectResponse - … - `object` 'block', required - `id` string, uuid, required - `created_time` string, date-time, required - `created_by` PartialUserObjectResponse, required - `id` string, uuid, required - `object` 'user', required — Always `user` - `last_edited_time` string, date-time, required - `last_edited_by` PartialUserObjectResponse, required - `id` string, uuid, required - `object` 'user', required — Always `user` - `has_children` boolean, required - `in_trash` boolean, required ## Other responses - `400` - `401` - `403` - `404` - `406` - `409` - `429` - `500` - `503` - `504` - `529` --- [API](https://skmtc.net/notion/apis/notion-api.md) · [All operations](https://skmtc.net/notion/apis/notion-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/notion/notion-api/versions/551da43bb186/schema)