---
title: "Delete a block"
method: DELETE
path: "/v1/blocks/{block_id}"
tags: ["Blocks"]
---

# Delete a block

`DELETE /v1/blocks/{block_id}`

## Path parameters

- `block_id` string, required

## Headers

- `Notion-Version` '2026-03-11', required

## Response `200`

- union
  - PartialBlockObjectResponse
    - `object` 'block', required
    - `id` string, uuid, required
  - union
    - ParagraphBlockObjectResponse
      - `type` 'paragraph', required
      - `paragraph` ContentWithRichTextColorAndIconResponse, required
        - `rich_text` RichTextItemResponse[], required
          - union
            - object
              - …
            - object
              - …
            - object
              - …
        - `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
          - EmojiPageIconResponse
            - `type` 'emoji', required — Type of icon. In this case, an emoji.
            - `emoji` string, required
          - FilePageIconResponse
            - `type` 'file', required — Type of icon. In this case, a file.
            - `file` InternalFileResponse, required
              - …
          - ExternalPageIconResponse
            - `type` 'external', required — Type of icon. In this case, an external URL.
            - `external` object, required — The external URL for the icon.
              - …
          - CustomEmojiPageIconResponse
            - `type` 'custom_emoji', required — Type of icon. In this case, a custom emoji.
            - `custom_emoji` CustomEmojiResponse, required
              - …
          - IconPageIconResponse
            - `type` 'icon', required — Type of icon. In this case, a Notion native icon.
            - `icon` NoticonIconResponse, required
              - …
      - `parent` union, required
        - DatabaseParentResponse
          - `type` 'database_id', required — The parent type.
          - `database_id` string, uuid, required
        - DataSourceParentResponse
          - `type` 'data_source_id', required — The parent type.
          - `data_source_id` string, uuid, required
          - `database_id` string, uuid, required
        - PageIdParentForBlockBasedObjectResponse
          - `type` 'page_id', required — The parent type.
          - `page_id` string, uuid, required
        - BlockIdParentForBlockBasedObjectResponse
          - `type` 'block_id', required — The parent type.
          - `block_id` string, uuid, required
        - AgentIdParentForBlockBasedObjectResponse
          - `type` 'agent_id', required — The parent type.
          - `agent_id` string, uuid, required
        - WorkspaceParentForBlockBasedObjectResponse
          - `type` 'workspace', required — The parent type.
          - `workspace` true, required — Always true for workspace parent.
      - `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
          - union
            - object
              - …
            - object
              - …
            - object
              - …
        - `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
          - `type` 'database_id', required — The parent type.
          - `database_id` string, uuid, required
        - DataSourceParentResponse
          - `type` 'data_source_id', required — The parent type.
          - `data_source_id` string, uuid, required
          - `database_id` string, uuid, required
        - PageIdParentForBlockBasedObjectResponse
          - `type` 'page_id', required — The parent type.
          - `page_id` string, uuid, required
        - BlockIdParentForBlockBasedObjectResponse
          - `type` 'block_id', required — The parent type.
          - `block_id` string, uuid, required
        - AgentIdParentForBlockBasedObjectResponse
          - `type` 'agent_id', required — The parent type.
          - `agent_id` string, uuid, required
        - WorkspaceParentForBlockBasedObjectResponse
          - `type` 'workspace', required — The parent type.
          - `workspace` true, required — Always true for workspace parent.
      - `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
          - union
            - object
              - …
            - object
              - …
            - object
              - …
        - `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
          - `type` 'database_id', required — The parent type.
          - `database_id` string, uuid, required
        - DataSourceParentResponse
          - `type` 'data_source_id', required — The parent type.
          - `data_source_id` string, uuid, required
          - `database_id` string, uuid, required
        - PageIdParentForBlockBasedObjectResponse
          - `type` 'page_id', required — The parent type.
          - `page_id` string, uuid, required
        - BlockIdParentForBlockBasedObjectResponse
          - `type` 'block_id', required — The parent type.
          - `block_id` string, uuid, required
        - AgentIdParentForBlockBasedObjectResponse
          - `type` 'agent_id', required — The parent type.
          - `agent_id` string, uuid, required
        - WorkspaceParentForBlockBasedObjectResponse
          - `type` 'workspace', required — The parent type.
          - `workspace` true, required — Always true for workspace parent.
      - `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
          - union
            - object
              - …
            - object
              - …
            - object
              - …
        - `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
          - `type` 'database_id', required — The parent type.
          - `database_id` string, uuid, required
        - DataSourceParentResponse
          - `type` 'data_source_id', required — The parent type.
          - `data_source_id` string, uuid, required
          - `database_id` string, uuid, required
        - PageIdParentForBlockBasedObjectResponse
          - `type` 'page_id', required — The parent type.
          - `page_id` string, uuid, required
        - BlockIdParentForBlockBasedObjectResponse
          - `type` 'block_id', required — The parent type.
          - `block_id` string, uuid, required
        - AgentIdParentForBlockBasedObjectResponse
          - `type` 'agent_id', required — The parent type.
          - `agent_id` string, uuid, required
        - WorkspaceParentForBlockBasedObjectResponse
          - `type` 'workspace', required — The parent type.
          - `workspace` true, required — Always true for workspace parent.
      - `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
          - union
            - object
              - …
            - object
              - …
            - object
              - …
        - `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
          - `type` 'database_id', required — The parent type.
          - `database_id` string, uuid, required
        - DataSourceParentResponse
          - `type` 'data_source_id', required — The parent type.
          - `data_source_id` string, uuid, required
          - `database_id` string, uuid, required
        - PageIdParentForBlockBasedObjectResponse
          - `type` 'page_id', required — The parent type.
          - `page_id` string, uuid, required
        - BlockIdParentForBlockBasedObjectResponse
          - `type` 'block_id', required — The parent type.
          - `block_id` string, uuid, required
        - AgentIdParentForBlockBasedObjectResponse
          - `type` 'agent_id', required — The parent type.
          - `agent_id` string, uuid, required
        - WorkspaceParentForBlockBasedObjectResponse
          - `type` 'workspace', required — The parent type.
          - `workspace` true, required — Always true for workspace parent.
      - `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
          - union
            - object
              - …
            - object
              - …
            - object
              - …
        - `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
          - `type` 'database_id', required — The parent type.
          - `database_id` string, uuid, required
        - DataSourceParentResponse
          - `type` 'data_source_id', required — The parent type.
          - `data_source_id` string, uuid, required
          - `database_id` string, uuid, required
        - PageIdParentForBlockBasedObjectResponse
          - `type` 'page_id', required — The parent type.
          - `page_id` string, uuid, required
        - BlockIdParentForBlockBasedObjectResponse
          - `type` 'block_id', required — The parent type.
          - `block_id` string, uuid, required
        - AgentIdParentForBlockBasedObjectResponse
          - `type` 'agent_id', required — The parent type.
          - `agent_id` string, uuid, required
        - WorkspaceParentForBlockBasedObjectResponse
          - `type` 'workspace', required — The parent type.
          - `workspace` true, required — Always true for workspace parent.
      - `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
          - union
            - object
              - …
            - object
              - …
            - object
              - …
        - `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
          - `type` 'database_id', required — The parent type.
          - `database_id` string, uuid, required
        - DataSourceParentResponse
          - `type` 'data_source_id', required — The parent type.
          - `data_source_id` string, uuid, required
          - `database_id` string, uuid, required
        - PageIdParentForBlockBasedObjectResponse
          - `type` 'page_id', required — The parent type.
          - `page_id` string, uuid, required
        - BlockIdParentForBlockBasedObjectResponse
          - `type` 'block_id', required — The parent type.
          - `block_id` string, uuid, required
        - AgentIdParentForBlockBasedObjectResponse
          - `type` 'agent_id', required — The parent type.
          - `agent_id` string, uuid, required
        - WorkspaceParentForBlockBasedObjectResponse
          - `type` 'workspace', required — The parent type.
          - `workspace` true, required — Always true for workspace parent.
      - `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
          - union
            - object
              - …
            - object
              - …
            - object
              - …
        - `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
          - `type` 'database_id', required — The parent type.
          - `database_id` string, uuid, required
        - DataSourceParentResponse
          - `type` 'data_source_id', required — The parent type.
          - `data_source_id` string, uuid, required
          - `database_id` string, uuid, required
        - PageIdParentForBlockBasedObjectResponse
          - `type` 'page_id', required — The parent type.
          - `page_id` string, uuid, required
        - BlockIdParentForBlockBasedObjectResponse
          - `type` 'block_id', required — The parent type.
          - `block_id` string, uuid, required
        - AgentIdParentForBlockBasedObjectResponse
          - `type` 'agent_id', required — The parent type.
          - `agent_id` string, uuid, required
        - WorkspaceParentForBlockBasedObjectResponse
          - `type` 'workspace', required — The parent type.
          - `workspace` true, required — Always true for workspace parent.
      - `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
          - union
            - object
              - …
            - object
              - …
            - object
              - …
        - `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
          - `type` 'database_id', required — The parent type.
          - `database_id` string, uuid, required
        - DataSourceParentResponse
          - `type` 'data_source_id', required — The parent type.
          - `data_source_id` string, uuid, required
          - `database_id` string, uuid, required
        - PageIdParentForBlockBasedObjectResponse
          - `type` 'page_id', required — The parent type.
          - `page_id` string, uuid, required
        - BlockIdParentForBlockBasedObjectResponse
          - `type` 'block_id', required — The parent type.
          - `block_id` string, uuid, required
        - AgentIdParentForBlockBasedObjectResponse
          - `type` 'agent_id', required — The parent type.
          - `agent_id` string, uuid, required
        - WorkspaceParentForBlockBasedObjectResponse
          - `type` 'workspace', required — The parent type.
          - `workspace` true, required — Always true for workspace parent.
      - `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
          - union
            - object
              - …
            - object
              - …
            - object
              - …
        - `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
          - `type` 'database_id', required — The parent type.
          - `database_id` string, uuid, required
        - DataSourceParentResponse
          - `type` 'data_source_id', required — The parent type.
          - `data_source_id` string, uuid, required
          - `database_id` string, uuid, required
        - PageIdParentForBlockBasedObjectResponse
          - `type` 'page_id', required — The parent type.
          - `page_id` string, uuid, required
        - BlockIdParentForBlockBasedObjectResponse
          - `type` 'block_id', required — The parent type.
          - `block_id` string, uuid, required
        - AgentIdParentForBlockBasedObjectResponse
          - `type` 'agent_id', required — The parent type.
          - `agent_id` string, uuid, required
        - WorkspaceParentForBlockBasedObjectResponse
          - `type` 'workspace', required — The parent type.
          - `workspace` true, required — Always true for workspace parent.
      - `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
          - union
            - object
              - …
            - object
              - …
            - object
              - …
      - `parent` union, required
        - DatabaseParentResponse
          - `type` 'database_id', required — The parent type.
          - `database_id` string, uuid, required
        - DataSourceParentResponse
          - `type` 'data_source_id', required — The parent type.
          - `data_source_id` string, uuid, required
          - `database_id` string, uuid, required
        - PageIdParentForBlockBasedObjectResponse
          - `type` 'page_id', required — The parent type.
          - `page_id` string, uuid, required
        - BlockIdParentForBlockBasedObjectResponse
          - `type` 'block_id', required — The parent type.
          - `block_id` string, uuid, required
        - AgentIdParentForBlockBasedObjectResponse
          - `type` 'agent_id', required — The parent type.
          - `agent_id` string, uuid, required
        - WorkspaceParentForBlockBasedObjectResponse
          - `type` 'workspace', required — The parent type.
          - `workspace` true, required — Always true for workspace parent.
      - `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
          - `type` 'block_id', required
          - `block_id` string, required
      - `parent` union, required
        - DatabaseParentResponse
          - `type` 'database_id', required — The parent type.
          - `database_id` string, uuid, required
        - DataSourceParentResponse
          - `type` 'data_source_id', required — The parent type.
          - `data_source_id` string, uuid, required
          - `database_id` string, uuid, required
        - PageIdParentForBlockBasedObjectResponse
          - `type` 'page_id', required — The parent type.
          - `page_id` string, uuid, required
        - BlockIdParentForBlockBasedObjectResponse
          - `type` 'block_id', required — The parent type.
          - `block_id` string, uuid, required
        - AgentIdParentForBlockBasedObjectResponse
          - `type` 'agent_id', required — The parent type.
          - `agent_id` string, uuid, required
        - WorkspaceParentForBlockBasedObjectResponse
          - `type` 'workspace', required — The parent type.
          - `workspace` true, required — Always true for workspace parent.
      - `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
          - `type` 'database_id', required — The parent type.
          - `database_id` string, uuid, required
        - DataSourceParentResponse
          - `type` 'data_source_id', required — The parent type.
          - `data_source_id` string, uuid, required
          - `database_id` string, uuid, required
        - PageIdParentForBlockBasedObjectResponse
          - `type` 'page_id', required — The parent type.
          - `page_id` string, uuid, required
        - BlockIdParentForBlockBasedObjectResponse
          - `type` 'block_id', required — The parent type.
          - `block_id` string, uuid, required
        - AgentIdParentForBlockBasedObjectResponse
          - `type` 'agent_id', required — The parent type.
          - `agent_id` string, uuid, required
        - WorkspaceParentForBlockBasedObjectResponse
          - `type` 'workspace', required — The parent type.
          - `workspace` true, required — Always true for workspace parent.
      - `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
          - `type` 'database_id', required — The parent type.
          - `database_id` string, uuid, required
        - DataSourceParentResponse
          - `type` 'data_source_id', required — The parent type.
          - `data_source_id` string, uuid, required
          - `database_id` string, uuid, required
        - PageIdParentForBlockBasedObjectResponse
          - `type` 'page_id', required — The parent type.
          - `page_id` string, uuid, required
        - BlockIdParentForBlockBasedObjectResponse
          - `type` 'block_id', required — The parent type.
          - `block_id` string, uuid, required
        - AgentIdParentForBlockBasedObjectResponse
          - `type` 'agent_id', required — The parent type.
          - `agent_id` string, uuid, required
        - WorkspaceParentForBlockBasedObjectResponse
          - `type` 'workspace', required — The parent type.
          - `workspace` true, required — Always true for workspace parent.
      - `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
          - `type` 'database_id', required — The parent type.
          - `database_id` string, uuid, required
        - DataSourceParentResponse
          - `type` 'data_source_id', required — The parent type.
          - `data_source_id` string, uuid, required
          - `database_id` string, uuid, required
        - PageIdParentForBlockBasedObjectResponse
          - `type` 'page_id', required — The parent type.
          - `page_id` string, uuid, required
        - BlockIdParentForBlockBasedObjectResponse
          - `type` 'block_id', required — The parent type.
          - `block_id` string, uuid, required
        - AgentIdParentForBlockBasedObjectResponse
          - `type` 'agent_id', required — The parent type.
          - `agent_id` string, uuid, required
        - WorkspaceParentForBlockBasedObjectResponse
          - `type` 'workspace', required — The parent type.
          - `workspace` true, required — Always true for workspace parent.
      - `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
          - union
            - object
              - …
            - object
              - …
            - object
              - …
        - `caption` RichTextItemResponse[], required
          - union
            - object
              - …
            - object
              - …
            - object
              - …
        - `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
          - `type` 'database_id', required — The parent type.
          - `database_id` string, uuid, required
        - DataSourceParentResponse
          - `type` 'data_source_id', required — The parent type.
          - `data_source_id` string, uuid, required
          - `database_id` string, uuid, required
        - PageIdParentForBlockBasedObjectResponse
          - `type` 'page_id', required — The parent type.
          - `page_id` string, uuid, required
        - BlockIdParentForBlockBasedObjectResponse
          - `type` 'block_id', required — The parent type.
          - `block_id` string, uuid, required
        - AgentIdParentForBlockBasedObjectResponse
          - `type` 'agent_id', required — The parent type.
          - `agent_id` string, uuid, required
        - WorkspaceParentForBlockBasedObjectResponse
          - `type` 'workspace', required — The parent type.
          - `workspace` true, required — Always true for workspace parent.
      - `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
          - union
            - object
              - …
            - object
              - …
            - object
              - …
        - `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
          - EmojiPageIconResponse
            - `type` 'emoji', required — Type of icon. In this case, an emoji.
            - `emoji` string, required
          - FilePageIconResponse
            - `type` 'file', required — Type of icon. In this case, a file.
            - `file` InternalFileResponse, required
              - …
          - ExternalPageIconResponse
            - `type` 'external', required — Type of icon. In this case, an external URL.
            - `external` object, required — The external URL for the icon.
              - …
          - CustomEmojiPageIconResponse
            - `type` 'custom_emoji', required — Type of icon. In this case, a custom emoji.
            - `custom_emoji` CustomEmojiResponse, required
              - …
          - IconPageIconResponse
            - `type` 'icon', required — Type of icon. In this case, a Notion native icon.
            - `icon` NoticonIconResponse, required
              - …
      - `parent` union, required
        - DatabaseParentResponse
          - `type` 'database_id', required — The parent type.
          - `database_id` string, uuid, required
        - DataSourceParentResponse
          - `type` 'data_source_id', required — The parent type.
          - `data_source_id` string, uuid, required
          - `database_id` string, uuid, required
        - PageIdParentForBlockBasedObjectResponse
          - `type` 'page_id', required — The parent type.
          - `page_id` string, uuid, required
        - BlockIdParentForBlockBasedObjectResponse
          - `type` 'block_id', required — The parent type.
          - `block_id` string, uuid, required
        - AgentIdParentForBlockBasedObjectResponse
          - `type` 'agent_id', required — The parent type.
          - `agent_id` string, uuid, required
        - WorkspaceParentForBlockBasedObjectResponse
          - `type` 'workspace', required — The parent type.
          - `workspace` true, required — Always true for workspace parent.
      - `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
          - `type` 'database_id', required — The parent type.
          - `database_id` string, uuid, required
        - DataSourceParentResponse
          - `type` 'data_source_id', required — The parent type.
          - `data_source_id` string, uuid, required
          - `database_id` string, uuid, required
        - PageIdParentForBlockBasedObjectResponse
          - `type` 'page_id', required — The parent type.
          - `page_id` string, uuid, required
        - BlockIdParentForBlockBasedObjectResponse
          - `type` 'block_id', required — The parent type.
          - `block_id` string, uuid, required
        - AgentIdParentForBlockBasedObjectResponse
          - `type` 'agent_id', required — The parent type.
          - `agent_id` string, uuid, required
        - WorkspaceParentForBlockBasedObjectResponse
          - `type` 'workspace', required — The parent type.
          - `workspace` true, required — Always true for workspace parent.
      - `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
          - `type` 'database_id', required — The parent type.
          - `database_id` string, uuid, required
        - DataSourceParentResponse
          - `type` 'data_source_id', required — The parent type.
          - `data_source_id` string, uuid, required
          - `database_id` string, uuid, required
        - PageIdParentForBlockBasedObjectResponse
          - `type` 'page_id', required — The parent type.
          - `page_id` string, uuid, required
        - BlockIdParentForBlockBasedObjectResponse
          - `type` 'block_id', required — The parent type.
          - `block_id` string, uuid, required
        - AgentIdParentForBlockBasedObjectResponse
          - `type` 'agent_id', required — The parent type.
          - `agent_id` string, uuid, required
        - WorkspaceParentForBlockBasedObjectResponse
          - `type` 'workspace', required — The parent type.
          - `workspace` true, required — Always true for workspace parent.
      - `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
          - `type` 'database_id', required — The parent type.
          - `database_id` string, uuid, required
        - DataSourceParentResponse
          - `type` 'data_source_id', required — The parent type.
          - `data_source_id` string, uuid, required
          - `database_id` string, uuid, required
        - PageIdParentForBlockBasedObjectResponse
          - `type` 'page_id', required — The parent type.
          - `page_id` string, uuid, required
        - BlockIdParentForBlockBasedObjectResponse
          - `type` 'block_id', required — The parent type.
          - `block_id` string, uuid, required
        - AgentIdParentForBlockBasedObjectResponse
          - `type` 'agent_id', required — The parent type.
          - `agent_id` string, uuid, required
        - WorkspaceParentForBlockBasedObjectResponse
          - `type` 'workspace', required — The parent type.
          - `workspace` true, required — Always true for workspace parent.
      - `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
          - `type` 'database_id', required — The parent type.
          - `database_id` string, uuid, required
        - DataSourceParentResponse
          - `type` 'data_source_id', required — The parent type.
          - `data_source_id` string, uuid, required
          - `database_id` string, uuid, required
        - PageIdParentForBlockBasedObjectResponse
          - `type` 'page_id', required — The parent type.
          - `page_id` string, uuid, required
        - BlockIdParentForBlockBasedObjectResponse
          - `type` 'block_id', required — The parent type.
          - `block_id` string, uuid, required
        - AgentIdParentForBlockBasedObjectResponse
          - `type` 'agent_id', required — The parent type.
          - `agent_id` string, uuid, required
        - WorkspaceParentForBlockBasedObjectResponse
          - `type` 'workspace', required — The parent type.
          - `workspace` true, required — Always true for workspace parent.
      - `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
          - `type` 'database_id', required — The parent type.
          - `database_id` string, uuid, required
        - DataSourceParentResponse
          - `type` 'data_source_id', required — The parent type.
          - `data_source_id` string, uuid, required
          - `database_id` string, uuid, required
        - PageIdParentForBlockBasedObjectResponse
          - `type` 'page_id', required — The parent type.
          - `page_id` string, uuid, required
        - BlockIdParentForBlockBasedObjectResponse
          - `type` 'block_id', required — The parent type.
          - `block_id` string, uuid, required
        - AgentIdParentForBlockBasedObjectResponse
          - `type` 'agent_id', required — The parent type.
          - `agent_id` string, uuid, required
        - WorkspaceParentForBlockBasedObjectResponse
          - `type` 'workspace', required — The parent type.
          - `workspace` true, required — Always true for workspace parent.
      - `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
          - `type` 'database_id', required — The parent type.
          - `database_id` string, uuid, required
        - DataSourceParentResponse
          - `type` 'data_source_id', required — The parent type.
          - `data_source_id` string, uuid, required
          - `database_id` string, uuid, required
        - PageIdParentForBlockBasedObjectResponse
          - `type` 'page_id', required — The parent type.
          - `page_id` string, uuid, required
        - BlockIdParentForBlockBasedObjectResponse
          - `type` 'block_id', required — The parent type.
          - `block_id` string, uuid, required
        - AgentIdParentForBlockBasedObjectResponse
          - `type` 'agent_id', required — The parent type.
          - `agent_id` string, uuid, required
        - WorkspaceParentForBlockBasedObjectResponse
          - `type` 'workspace', required — The parent type.
          - `workspace` true, required — Always true for workspace parent.
      - `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
          - `type` 'page_id', required
          - `page_id` string, required
        - object
          - `type` 'database_id', required
          - `database_id` string, required
        - object
          - `type` 'comment_id', required
          - `comment_id` string, required
      - `parent` union, required
        - DatabaseParentResponse
          - `type` 'database_id', required — The parent type.
          - `database_id` string, uuid, required
        - DataSourceParentResponse
          - `type` 'data_source_id', required — The parent type.
          - `data_source_id` string, uuid, required
          - `database_id` string, uuid, required
        - PageIdParentForBlockBasedObjectResponse
          - `type` 'page_id', required — The parent type.
          - `page_id` string, uuid, required
        - BlockIdParentForBlockBasedObjectResponse
          - `type` 'block_id', required — The parent type.
          - `block_id` string, uuid, required
        - AgentIdParentForBlockBasedObjectResponse
          - `type` 'agent_id', required — The parent type.
          - `agent_id` string, uuid, required
        - WorkspaceParentForBlockBasedObjectResponse
          - `type` 'workspace', required — The parent type.
          - `workspace` true, required — Always true for workspace parent.
      - `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
          - `type` 'database_id', required — The parent type.
          - `database_id` string, uuid, required
        - DataSourceParentResponse
          - `type` 'data_source_id', required — The parent type.
          - `data_source_id` string, uuid, required
          - `database_id` string, uuid, required
        - PageIdParentForBlockBasedObjectResponse
          - `type` 'page_id', required — The parent type.
          - `page_id` string, uuid, required
        - BlockIdParentForBlockBasedObjectResponse
          - `type` 'block_id', required — The parent type.
          - `block_id` string, uuid, required
        - AgentIdParentForBlockBasedObjectResponse
          - `type` 'agent_id', required — The parent type.
          - `agent_id` string, uuid, required
        - WorkspaceParentForBlockBasedObjectResponse
          - `type` 'workspace', required — The parent type.
          - `workspace` true, required — Always true for workspace parent.
      - `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
          - RichTextItemResponse[]
            - union
              - …
      - `parent` union, required
        - DatabaseParentResponse
          - `type` 'database_id', required — The parent type.
          - `database_id` string, uuid, required
        - DataSourceParentResponse
          - `type` 'data_source_id', required — The parent type.
          - `data_source_id` string, uuid, required
          - `database_id` string, uuid, required
        - PageIdParentForBlockBasedObjectResponse
          - `type` 'page_id', required — The parent type.
          - `page_id` string, uuid, required
        - BlockIdParentForBlockBasedObjectResponse
          - `type` 'block_id', required — The parent type.
          - `block_id` string, uuid, required
        - AgentIdParentForBlockBasedObjectResponse
          - `type` 'agent_id', required — The parent type.
          - `agent_id` string, uuid, required
        - WorkspaceParentForBlockBasedObjectResponse
          - `type` 'workspace', required — The parent type.
          - `workspace` true, required — Always true for workspace parent.
      - `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[]
          - union
            - object
              - …
            - object
              - …
            - object
              - …
        - `status` 'transcription_not_started' | 'transcription_paused' | 'transcription_in_progress' | 'transcription_failed' | 'summary_in_progress' | 'notes_ready'
        - `children` TranscriptionChildrenResponse
          - `summary_block_id` string
          - `notes_block_id` string
          - `transcript_block_id` string
        - `calendar_event` TranscriptionCalendarEventResponse
          - `start_time` string, date-time, required
          - `end_time` string, date-time, required
          - `attendees` IdRequest[]
        - `recording` TranscriptionRecordingResponse
          - `start_time` string, date-time
          - `end_time` string, date-time
      - `parent` union, required
        - DatabaseParentResponse
          - `type` 'database_id', required — The parent type.
          - `database_id` string, uuid, required
        - DataSourceParentResponse
          - `type` 'data_source_id', required — The parent type.
          - `data_source_id` string, uuid, required
          - `database_id` string, uuid, required
        - PageIdParentForBlockBasedObjectResponse
          - `type` 'page_id', required — The parent type.
          - `page_id` string, uuid, required
        - BlockIdParentForBlockBasedObjectResponse
          - `type` 'block_id', required — The parent type.
          - `block_id` string, uuid, required
        - AgentIdParentForBlockBasedObjectResponse
          - `type` 'agent_id', required — The parent type.
          - `agent_id` string, uuid, required
        - WorkspaceParentForBlockBasedObjectResponse
          - `type` 'workspace', required — The parent type.
          - `workspace` true, required — Always true for workspace parent.
      - `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
          - union
            - object
              - …
            - object
              - …
            - object
              - …
      - `parent` union, required
        - DatabaseParentResponse
          - `type` 'database_id', required — The parent type.
          - `database_id` string, uuid, required
        - DataSourceParentResponse
          - `type` 'data_source_id', required — The parent type.
          - `data_source_id` string, uuid, required
          - `database_id` string, uuid, required
        - PageIdParentForBlockBasedObjectResponse
          - `type` 'page_id', required — The parent type.
          - `page_id` string, uuid, required
        - BlockIdParentForBlockBasedObjectResponse
          - `type` 'block_id', required — The parent type.
          - `block_id` string, uuid, required
        - AgentIdParentForBlockBasedObjectResponse
          - `type` 'agent_id', required — The parent type.
          - `agent_id` string, uuid, required
        - WorkspaceParentForBlockBasedObjectResponse
          - `type` 'workspace', required — The parent type.
          - `workspace` true, required — Always true for workspace parent.
      - `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
          - union
            - object
              - …
            - object
              - …
            - object
              - …
      - `parent` union, required
        - DatabaseParentResponse
          - `type` 'database_id', required — The parent type.
          - `database_id` string, uuid, required
        - DataSourceParentResponse
          - `type` 'data_source_id', required — The parent type.
          - `data_source_id` string, uuid, required
          - `database_id` string, uuid, required
        - PageIdParentForBlockBasedObjectResponse
          - `type` 'page_id', required — The parent type.
          - `page_id` string, uuid, required
        - BlockIdParentForBlockBasedObjectResponse
          - `type` 'block_id', required — The parent type.
          - `block_id` string, uuid, required
        - AgentIdParentForBlockBasedObjectResponse
          - `type` 'agent_id', required — The parent type.
          - `agent_id` string, uuid, required
        - WorkspaceParentForBlockBasedObjectResponse
          - `type` 'workspace', required — The parent type.
          - `workspace` true, required — Always true for workspace parent.
      - `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
          - `type` 'external', required
          - `external` object, required
            - `url` string, required
          - `caption` RichTextItemResponse[], required
            - union
              - …
        - FileMediaContentWithFileAndCaptionResponse
          - `type` 'file', required
          - `file` InternalFileResponse, required
            - `url` string, required — The URL of the file.
            - `expiry_time` string, date-time, required — The time when the URL will expire.
          - `caption` RichTextItemResponse[], required
            - union
              - …
      - `parent` union, required
        - DatabaseParentResponse
          - `type` 'database_id', required — The parent type.
          - `database_id` string, uuid, required
        - DataSourceParentResponse
          - `type` 'data_source_id', required — The parent type.
          - `data_source_id` string, uuid, required
          - `database_id` string, uuid, required
        - PageIdParentForBlockBasedObjectResponse
          - `type` 'page_id', required — The parent type.
          - `page_id` string, uuid, required
        - BlockIdParentForBlockBasedObjectResponse
          - `type` 'block_id', required — The parent type.
          - `block_id` string, uuid, required
        - AgentIdParentForBlockBasedObjectResponse
          - `type` 'agent_id', required — The parent type.
          - `agent_id` string, uuid, required
        - WorkspaceParentForBlockBasedObjectResponse
          - `type` 'workspace', required — The parent type.
          - `workspace` true, required — Always true for workspace parent.
      - `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
          - `type` 'external', required
          - `external` object, required
            - `url` string, required
          - `caption` RichTextItemResponse[], required
            - union
              - …
        - FileMediaContentWithFileAndCaptionResponse
          - `type` 'file', required
          - `file` InternalFileResponse, required
            - `url` string, required — The URL of the file.
            - `expiry_time` string, date-time, required — The time when the URL will expire.
          - `caption` RichTextItemResponse[], required
            - union
              - …
      - `parent` union, required
        - DatabaseParentResponse
          - `type` 'database_id', required — The parent type.
          - `database_id` string, uuid, required
        - DataSourceParentResponse
          - `type` 'data_source_id', required — The parent type.
          - `data_source_id` string, uuid, required
          - `database_id` string, uuid, required
        - PageIdParentForBlockBasedObjectResponse
          - `type` 'page_id', required — The parent type.
          - `page_id` string, uuid, required
        - BlockIdParentForBlockBasedObjectResponse
          - `type` 'block_id', required — The parent type.
          - `block_id` string, uuid, required
        - AgentIdParentForBlockBasedObjectResponse
          - `type` 'agent_id', required — The parent type.
          - `agent_id` string, uuid, required
        - WorkspaceParentForBlockBasedObjectResponse
          - `type` 'workspace', required — The parent type.
          - `workspace` true, required — Always true for workspace parent.
      - `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
          - `type` 'external', required
          - `external` object, required
            - `url` string, required
          - `caption` RichTextItemResponse[], required
            - union
              - …
        - FileMediaContentWithFileAndCaptionResponse
          - `type` 'file', required
          - `file` InternalFileResponse, required
            - `url` string, required — The URL of the file.
            - `expiry_time` string, date-time, required — The time when the URL will expire.
          - `caption` RichTextItemResponse[], required
            - union
              - …
      - `parent` union, required
        - DatabaseParentResponse
          - `type` 'database_id', required — The parent type.
          - `database_id` string, uuid, required
        - DataSourceParentResponse
          - `type` 'data_source_id', required — The parent type.
          - `data_source_id` string, uuid, required
          - `database_id` string, uuid, required
        - PageIdParentForBlockBasedObjectResponse
          - `type` 'page_id', required — The parent type.
          - `page_id` string, uuid, required
        - BlockIdParentForBlockBasedObjectResponse
          - `type` 'block_id', required — The parent type.
          - `block_id` string, uuid, required
        - AgentIdParentForBlockBasedObjectResponse
          - `type` 'agent_id', required — The parent type.
          - `agent_id` string, uuid, required
        - WorkspaceParentForBlockBasedObjectResponse
          - `type` 'workspace', required — The parent type.
          - `workspace` true, required — Always true for workspace parent.
      - `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
- … truncated; see the full OpenAPI document linked below

## 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)
