> ## Documentation Index
> Fetch the complete documentation index at: https://docs.r28.ai/charter/llms.txt
> Use this file to discover all available pages before exploring further.

# Objects

> Every object and enum the Blocks tools accept.

## Model tree

<div className="model-tree"><div className="model-tree-scroll"><div className="tree-node"><a href="#blockupdatebody">BlockUpdateBody</a></div><div className="tree-node"><a href="#blockchildrenappendbody">BlockChildrenAppendBody</a></div></div></div>

## BlockUpdateBody

The body of an update-block request.

<div className="reference-table">
  | Field              | Type                                                                                             | Description                                                                                                       |
  | ------------------ | ------------------------------------------------------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------- |
  | `type`             | `string`                                                                                         | Which kind of block this is. Returned on a read; on a write Notion infers it from whichever content field is set. |
  | `code`             | [CodeContent](/charter/charter/packs/notion/pages/objects#codecontent)                                   | A block of code.                                                                                                  |
  | `equation`         | [EquationBlockContent](/charter/charter/packs/notion/pages/objects#equationblockcontent)                 | A standalone LaTeX equation.                                                                                      |
  | `image`            | [MediaContent](/charter/charter/packs/notion/pages/objects#mediacontent)                                 | An image.                                                                                                         |
  | `video`            | [MediaContent](/charter/charter/packs/notion/pages/objects#mediacontent)                                 | A video.                                                                                                          |
  | `audio`            | [MediaContent](/charter/charter/packs/notion/pages/objects#mediacontent)                                 | An audio clip.                                                                                                    |
  | `pdf`              | [MediaContent](/charter/charter/packs/notion/pages/objects#mediacontent)                                 | A PDF.                                                                                                            |
  | `file`             | [FileBlockContent](/charter/charter/packs/notion/pages/objects#fileblockcontent)                         | A file attachment.                                                                                                |
  | `embed`            | [EmbedContent](/charter/charter/packs/notion/pages/objects#embedcontent)                                 | Third-party content rendered inline.                                                                              |
  | `bookmark`         | [BookmarkContent](/charter/charter/packs/notion/pages/objects#bookmarkcontent)                           | A link rendered as a bookmark card.                                                                               |
  | `divider`          | [EmptyContent](/charter/charter/packs/notion/pages/objects#emptycontent)                                 | A horizontal rule. Send an empty object.                                                                          |
  | `breadcrumb`       | [EmptyContent](/charter/charter/packs/notion/pages/objects#emptycontent)                                 | The page's ancestry. Send an empty object.                                                                        |
  | `tableOfContents`  | [TableOfContentsContent](/charter/charter/packs/notion/pages/objects#tableofcontentscontent)             | A table of contents built from the page's headings.                                                               |
  | `tableRow`         | [TableRowContent](/charter/charter/packs/notion/pages/objects#tablerowcontent)                           | One row of a table.                                                                                               |
  | `linkToPage`       | [LinkToPageContent](/charter/charter/packs/notion/pages/objects#linktopagecontent)                       | A link to another page, database or comment.                                                                      |
  | `paragraph`        | [BlockParagraphContent](/charter/charter/packs/notion/pages/objects#blockparagraphcontent)               | A paragraph of text.                                                                                              |
  | `heading1`         | [BlockHeadingContent](/charter/charter/packs/notion/pages/objects#blockheadingcontent)                   | A top-level heading.                                                                                              |
  | `heading2`         | [BlockHeadingContent](/charter/charter/packs/notion/pages/objects#blockheadingcontent)                   | A second-level heading.                                                                                           |
  | `heading3`         | [BlockHeadingContent](/charter/charter/packs/notion/pages/objects#blockheadingcontent)                   | A third-level heading.                                                                                            |
  | `heading4`         | [BlockHeadingContent](/charter/charter/packs/notion/pages/objects#blockheadingcontent)                   | A fourth-level heading.                                                                                           |
  | `bulletedListItem` | [BlockTextContent](/charter/charter/packs/notion/pages/objects#blocktextcontent)                         | A bulleted list item.                                                                                             |
  | `numberedListItem` | [BlockNumberedListItemContent](/charter/charter/packs/notion/pages/objects#blocknumberedlistitemcontent) | A numbered list item.                                                                                             |
  | `toDo`             | [BlockToDoContent](/charter/charter/packs/notion/pages/objects#blocktodocontent)                         | A checklist item.                                                                                                 |
  | `toggle`           | [BlockTextContent](/charter/charter/packs/notion/pages/objects#blocktextcontent)                         | A toggle, which collapses the blocks beneath it.                                                                  |
  | `quote`            | [BlockTextContent](/charter/charter/packs/notion/pages/objects#blocktextcontent)                         | A quotation.                                                                                                      |
  | `callout`          | [BlockCalloutContent](/charter/charter/packs/notion/pages/objects#blockcalloutcontent)                   | A callout — text in a tinted box with an icon.                                                                    |
  | `template`         | [BlockTemplateContent](/charter/charter/packs/notion/pages/objects#blocktemplatecontent)                 | A template button. Deprecated by Notion.                                                                          |
  | `syncedBlock`      | [BlockSyncedBlockContent](/charter/charter/packs/notion/pages/objects#blocksyncedblockcontent)           | Content mirrored between two places.                                                                              |
  | `tab`              | [BlockTabContent](/charter/charter/packs/notion/pages/objects#blocktabcontent)                           | A set of tabs.                                                                                                    |
  | `table`            | [BlockTableContent](/charter/charter/packs/notion/pages/objects#blocktablecontent)                       | A table.                                                                                                          |
  | `column`           | [BlockColumnContent](/charter/charter/packs/notion/pages/objects#blockcolumncontent)                     | One column of a column list.                                                                                      |
  | `inTrash`          | `boolean`                                                                                        | Whether the block is in the trash. False restores it.                                                             |
</div>

## BlockChildrenAppendBody

The body of an append-children request.

<div className="reference-table">
  | Field                                                            | Type                                                     | Description                                                                                                                                                                                         |
  | ---------------------------------------------------------------- | -------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
  | `children` <span className="required" title="required">\*</span> | [Block](/charter/charter/packs/notion/pages/objects#block)\[]    | The blocks to append. At most 100 per call, nested at most two levels deep — build deeper trees by appending to the blocks that come back. <span className="field-constraints">max 100 items</span> |
  | `position`                                                       | [Position](/charter/charter/packs/notion/pages/objects#position) | Where among the existing children the new blocks land. Appended to the end when absent.                                                                                                             |
</div>
