> ## 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 Pages tools accept.

## Model tree

<div className="model-tree"><div className="model-tree-scroll"><div className="tree-node"><a href="#pagecreatebody">PageCreateBody</a><div className="tree-children"><div className="tree-node"><a href="#parent">Parent</a></div><div className="tree-node"><a href="#pagepropertyvalue">PagePropertyValue</a><div className="tree-children"><div className="tree-node"><a href="#richtext">RichText</a><div className="tree-children"><div className="tree-node"><a href="#textcontent">TextContent</a><div className="tree-children"><div className="tree-node"><a href="#textlink">TextLink</a></div></div></div><div className="tree-node"><a href="#mention">Mention</a><div className="tree-children"><div className="tree-node"><a href="#partialuser">PartialUser</a></div><div className="tree-node"><a href="#pageref">PageRef</a></div><div className="tree-node"><a href="#databaseref">DatabaseRef</a></div><div className="tree-node"><a href="#datevalue">DateValue</a></div><div className="tree-node"><a href="#linkpreviewref">LinkPreviewRef</a></div><div className="tree-node"><a href="#templatemention">TemplateMention</a></div></div></div><div className="tree-node"><a href="#equationcontent">EquationContent</a></div><div className="tree-node"><a href="#annotations">Annotations</a></div></div></div><div className="tree-node"><a href="#selectvalue">SelectValue</a></div><div className="tree-node"><a href="#statusvalue">StatusValue</a></div><div className="tree-node"><a href="#datevalue">DateValue</a></div><div className="tree-node"><a href="#partialuser">PartialUser</a></div><div className="tree-node"><a href="#fileobject">FileObject</a><div className="tree-children"><div className="tree-node"><a href="#externalfiledata">ExternalFileData</a></div><div className="tree-node"><a href="#fileuploadref">FileUploadRef</a></div></div></div><div className="tree-node"><a href="#relationref">RelationRef</a></div><div className="tree-node"><a href="#verificationvalue">VerificationValue</a><div className="tree-children"><div className="tree-node"><a href="#datevalue">DateValue</a></div><div className="tree-node"><a href="#partialuser">PartialUser</a></div></div></div></div></div><div className="tree-node"><a href="#icon">Icon</a><div className="tree-children"><div className="tree-node"><a href="#externalfiledata">ExternalFileData</a></div><div className="tree-node"><a href="#fileuploadref">FileUploadRef</a></div><div className="tree-node"><a href="#customemojidata">CustomEmojiData</a></div><div className="tree-node"><a href="#notionicondata">NotionIconData</a></div></div></div><div className="tree-node"><a href="#cover">Cover</a><div className="tree-children"><div className="tree-node"><a href="#externalfiledata">ExternalFileData</a></div><div className="tree-node"><a href="#fileuploadref">FileUploadRef</a></div></div></div><div className="tree-node"><a href="#block">Block</a><div className="tree-children"><div className="tree-node"><a href="#codecontent">CodeContent</a><div className="tree-children"><div className="tree-node"><a href="#richtext">RichText</a> <span className="tree-note">above</span></div></div></div><div className="tree-node"><a href="#equationblockcontent">EquationBlockContent</a></div><div className="tree-node"><a href="#mediacontent">MediaContent</a><div className="tree-children"><div className="tree-node"><a href="#externalfiledata">ExternalFileData</a></div><div className="tree-node"><a href="#fileuploadref">FileUploadRef</a></div><div className="tree-node"><a href="#richtext">RichText</a> <span className="tree-note">above</span></div></div></div><div className="tree-node"><a href="#fileblockcontent">FileBlockContent</a><div className="tree-children"><div className="tree-node"><a href="#externalfiledata">ExternalFileData</a></div><div className="tree-node"><a href="#fileuploadref">FileUploadRef</a></div><div className="tree-node"><a href="#richtext">RichText</a> <span className="tree-note">above</span></div></div></div><div className="tree-node"><a href="#embedcontent">EmbedContent</a><div className="tree-children"><div className="tree-node"><a href="#fileuploadref">FileUploadRef</a></div><div className="tree-node"><a href="#richtext">RichText</a> <span className="tree-note">above</span></div></div></div><div className="tree-node"><a href="#bookmarkcontent">BookmarkContent</a><div className="tree-children"><div className="tree-node"><a href="#richtext">RichText</a> <span className="tree-note">above</span></div></div></div><div className="tree-node"><a href="#emptycontent">EmptyContent</a></div><div className="tree-node"><a href="#tableofcontentscontent">TableOfContentsContent</a></div><div className="tree-node"><a href="#tablerowcontent">TableRowContent</a><div className="tree-children"><div className="tree-node"><a href="#richtext">RichText</a> <span className="tree-note">above</span></div></div></div><div className="tree-node"><a href="#linktopagecontent">LinkToPageContent</a></div><div className="tree-node"><a href="#parent">Parent</a></div><div className="tree-node"><a href="#partialuser">PartialUser</a></div><div className="tree-node"><a href="#blockparagraphcontent">BlockParagraphContent</a><div className="tree-children"><div className="tree-node"><a href="#richtext">RichText</a> <span className="tree-note">above</span></div><div className="tree-node"><a href="#icon">Icon</a> <span className="tree-note">above</span></div><div className="tree-node"><a href="#nestedblock">NestedBlock</a><div className="tree-children"><div className="tree-node"><a href="#codecontent">CodeContent</a> <span className="tree-note">above</span></div><div className="tree-node"><a href="#equationblockcontent">EquationBlockContent</a></div><div className="tree-node"><a href="#mediacontent">MediaContent</a> <span className="tree-note">above</span></div><div className="tree-node"><a href="#fileblockcontent">FileBlockContent</a> <span className="tree-note">above</span></div><div className="tree-node"><a href="#embedcontent">EmbedContent</a> <span className="tree-note">above</span></div><div className="tree-node"><a href="#bookmarkcontent">BookmarkContent</a> <span className="tree-note">above</span></div><div className="tree-node"><a href="#emptycontent">EmptyContent</a></div><div className="tree-node"><a href="#tableofcontentscontent">TableOfContentsContent</a></div><div className="tree-node"><a href="#tablerowcontent">TableRowContent</a> <span className="tree-note">above</span></div><div className="tree-node"><a href="#linktopagecontent">LinkToPageContent</a></div><div className="tree-node"><a href="#parent">Parent</a></div><div className="tree-node"><a href="#partialuser">PartialUser</a></div><div className="tree-node"><a href="#nestedparagraphcontent">NestedParagraphContent</a><div className="tree-children"><div className="tree-node"><a href="#richtext">RichText</a> <span className="tree-note">above</span></div><div className="tree-node"><a href="#icon">Icon</a> <span className="tree-note">above</span></div><div className="tree-node"><a href="#leafblock">LeafBlock</a><div className="tree-children"><div className="tree-node"><a href="#codecontent">CodeContent</a> <span className="tree-note">above</span></div><div className="tree-node"><a href="#equationblockcontent">EquationBlockContent</a></div><div className="tree-node"><a href="#mediacontent">MediaContent</a> <span className="tree-note">above</span></div><div className="tree-node"><a href="#fileblockcontent">FileBlockContent</a> <span className="tree-note">above</span></div><div className="tree-node"><a href="#embedcontent">EmbedContent</a> <span className="tree-note">above</span></div><div className="tree-node"><a href="#bookmarkcontent">BookmarkContent</a> <span className="tree-note">above</span></div><div className="tree-node"><a href="#emptycontent">EmptyContent</a></div><div className="tree-node"><a href="#tableofcontentscontent">TableOfContentsContent</a></div><div className="tree-node"><a href="#tablerowcontent">TableRowContent</a> <span className="tree-note">above</span></div><div className="tree-node"><a href="#linktopagecontent">LinkToPageContent</a></div><div className="tree-node"><a href="#parent">Parent</a></div><div className="tree-node"><a href="#partialuser">PartialUser</a></div><div className="tree-node"><a href="#paragraphcontent">ParagraphContent</a><div className="tree-children"><div className="tree-node"><a href="#richtext">RichText</a> <span className="tree-note">above</span></div><div className="tree-node"><a href="#icon">Icon</a> <span className="tree-note">above</span></div></div></div><div className="tree-node"><a href="#headingcontent">HeadingContent</a><div className="tree-children"><div className="tree-node"><a href="#richtext">RichText</a> <span className="tree-note">above</span></div></div></div><div className="tree-node"><a href="#textblockcontent">TextBlockContent</a><div className="tree-children"><div className="tree-node"><a href="#richtext">RichText</a> <span className="tree-note">above</span></div></div></div><div className="tree-node"><a href="#numberedlistitemcontent">NumberedListItemContent</a><div className="tree-children"><div className="tree-node"><a href="#richtext">RichText</a> <span className="tree-note">above</span></div></div></div><div className="tree-node"><a href="#todocontent">ToDoContent</a><div className="tree-children"><div className="tree-node"><a href="#richtext">RichText</a> <span className="tree-note">above</span></div></div></div><div className="tree-node"><a href="#calloutcontent">CalloutContent</a><div className="tree-children"><div className="tree-node"><a href="#richtext">RichText</a> <span className="tree-note">above</span></div><div className="tree-node"><a href="#icon">Icon</a> <span className="tree-note">above</span></div></div></div><div className="tree-node"><a href="#templatecontent">TemplateContent</a><div className="tree-children"><div className="tree-node"><a href="#richtext">RichText</a> <span className="tree-note">above</span></div></div></div><div className="tree-node"><a href="#syncedblockcontent">SyncedBlockContent</a><div className="tree-children"><div className="tree-node"><a href="#syncedfromref">SyncedFromRef</a></div></div></div><div className="tree-node"><a href="#tabcontent">TabContent</a></div></div></div></div></div><div className="tree-node"><a href="#nestedheadingcontent">NestedHeadingContent</a><div className="tree-children"><div className="tree-node"><a href="#richtext">RichText</a> <span className="tree-note">above</span></div><div className="tree-node"><a href="#leafblock">LeafBlock</a> <span className="tree-note">above</span></div></div></div><div className="tree-node"><a href="#nestedtextblockcontent">NestedTextBlockContent</a><div className="tree-children"><div className="tree-node"><a href="#richtext">RichText</a> <span className="tree-note">above</span></div><div className="tree-node"><a href="#leafblock">LeafBlock</a> <span className="tree-note">above</span></div></div></div><div className="tree-node"><a href="#nestednumberedlistitemcontent">NestedNumberedListItemContent</a><div className="tree-children"><div className="tree-node"><a href="#richtext">RichText</a> <span className="tree-note">above</span></div><div className="tree-node"><a href="#leafblock">LeafBlock</a> <span className="tree-note">above</span></div></div></div><div className="tree-node"><a href="#nestedtodocontent">NestedToDoContent</a><div className="tree-children"><div className="tree-node"><a href="#richtext">RichText</a> <span className="tree-note">above</span></div><div className="tree-node"><a href="#leafblock">LeafBlock</a> <span className="tree-note">above</span></div></div></div><div className="tree-node"><a href="#nestedcalloutcontent">NestedCalloutContent</a><div className="tree-children"><div className="tree-node"><a href="#richtext">RichText</a> <span className="tree-note">above</span></div><div className="tree-node"><a href="#icon">Icon</a> <span className="tree-note">above</span></div><div className="tree-node"><a href="#leafblock">LeafBlock</a> <span className="tree-note">above</span></div></div></div><div className="tree-node"><a href="#nestedtemplatecontent">NestedTemplateContent</a><div className="tree-children"><div className="tree-node"><a href="#richtext">RichText</a> <span className="tree-note">above</span></div><div className="tree-node"><a href="#leafblock">LeafBlock</a> <span className="tree-note">above</span></div></div></div><div className="tree-node"><a href="#nestedsyncedblockcontent">NestedSyncedBlockContent</a><div className="tree-children"><div className="tree-node"><a href="#syncedfromref">SyncedFromRef</a></div><div className="tree-node"><a href="#leafblock">LeafBlock</a> <span className="tree-note">above</span></div></div></div><div className="tree-node"><a href="#nestedtabcontent">NestedTabContent</a><div className="tree-children"><div className="tree-node"><a href="#leafblock">LeafBlock</a> <span className="tree-note">above</span></div></div></div><div className="tree-node"><a href="#nestedtablecontent">NestedTableContent</a><div className="tree-children"><div className="tree-node"><a href="#leafblock">LeafBlock</a> <span className="tree-note">above</span></div></div></div></div></div></div></div><div className="tree-node"><a href="#blockheadingcontent">BlockHeadingContent</a><div className="tree-children"><div className="tree-node"><a href="#richtext">RichText</a> <span className="tree-note">above</span></div><div className="tree-node"><a href="#nestedblock">NestedBlock</a> <span className="tree-note">above</span></div></div></div><div className="tree-node"><a href="#blocktextcontent">BlockTextContent</a><div className="tree-children"><div className="tree-node"><a href="#richtext">RichText</a> <span className="tree-note">above</span></div><div className="tree-node"><a href="#nestedblock">NestedBlock</a> <span className="tree-note">above</span></div></div></div><div className="tree-node"><a href="#blocknumberedlistitemcontent">BlockNumberedListItemContent</a><div className="tree-children"><div className="tree-node"><a href="#richtext">RichText</a> <span className="tree-note">above</span></div><div className="tree-node"><a href="#nestedblock">NestedBlock</a> <span className="tree-note">above</span></div></div></div><div className="tree-node"><a href="#blocktodocontent">BlockToDoContent</a><div className="tree-children"><div className="tree-node"><a href="#richtext">RichText</a> <span className="tree-note">above</span></div><div className="tree-node"><a href="#nestedblock">NestedBlock</a> <span className="tree-note">above</span></div></div></div><div className="tree-node"><a href="#blockcalloutcontent">BlockCalloutContent</a><div className="tree-children"><div className="tree-node"><a href="#richtext">RichText</a> <span className="tree-note">above</span></div><div className="tree-node"><a href="#icon">Icon</a> <span className="tree-note">above</span></div><div className="tree-node"><a href="#nestedblock">NestedBlock</a> <span className="tree-note">above</span></div></div></div><div className="tree-node"><a href="#blocktemplatecontent">BlockTemplateContent</a><div className="tree-children"><div className="tree-node"><a href="#richtext">RichText</a> <span className="tree-note">above</span></div><div className="tree-node"><a href="#nestedblock">NestedBlock</a> <span className="tree-note">above</span></div></div></div><div className="tree-node"><a href="#blocksyncedblockcontent">BlockSyncedBlockContent</a><div className="tree-children"><div className="tree-node"><a href="#syncedfromref">SyncedFromRef</a></div><div className="tree-node"><a href="#nestedblock">NestedBlock</a> <span className="tree-note">above</span></div></div></div><div className="tree-node"><a href="#blocktabcontent">BlockTabContent</a><div className="tree-children"><div className="tree-node"><a href="#nestedblock">NestedBlock</a> <span className="tree-note">above</span></div></div></div><div className="tree-node"><a href="#blocktablecontent">BlockTableContent</a><div className="tree-children"><div className="tree-node"><a href="#nestedblock">NestedBlock</a> <span className="tree-note">above</span></div></div></div><div className="tree-node"><a href="#blockcolumnlistcontent">BlockColumnListContent</a><div className="tree-children"><div className="tree-node"><a href="#nestedblock">NestedBlock</a> <span className="tree-note">above</span></div></div></div><div className="tree-node"><a href="#blockcolumncontent">BlockColumnContent</a><div className="tree-children"><div className="tree-node"><a href="#nestedblock">NestedBlock</a> <span className="tree-note">above</span></div></div></div></div></div><div className="tree-node"><a href="#template">Template</a></div><div className="tree-node"><a href="#position">Position</a><div className="tree-children"><div className="tree-node"><a href="#afterblockref">AfterBlockRef</a></div></div></div></div></div><div className="tree-node"><a href="#pageupdatebody">PageUpdateBody</a><div className="tree-children"><div className="tree-node"><a href="#pagepropertyvalue">PagePropertyValue</a> <span className="tree-note">above</span></div><div className="tree-node"><a href="#icon">Icon</a> <span className="tree-note">above</span></div><div className="tree-node"><a href="#cover">Cover</a> <span className="tree-note">above</span></div><div className="tree-node"><a href="#template">Template</a></div></div></div><div className="tree-node"><a href="#pagemovebody">PageMoveBody</a><div className="tree-children"><div className="tree-node"><a href="#parent">Parent</a></div></div></div><div className="tree-node"><a href="#pagemarkdownupdatebody">PageMarkdownUpdateBody</a><div className="tree-children"><div className="tree-node"><a href="#updatecontentop">UpdateContentOp</a><div className="tree-children"><div className="tree-node"><a href="#contentupdate">ContentUpdate</a></div></div></div><div className="tree-node"><a href="#replacecontentop">ReplaceContentOp</a></div></div></div></div></div>

## PageCreateBody

The body of a create-page request.

<div className="reference-table">
  | Field                                                          | Type                                           | Description                                                                                                                                                                                       |
  | -------------------------------------------------------------- | ---------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
  | `parent` <span className="required" title="required">\*</span> | [Parent](#parent)                              | Where the page is created: `page_id` for a subpage, or `data_source_id` to add a row to a database.                                                                                               |
  | `properties`                                                   | map of [PagePropertyValue](#pagepropertyvalue) | The values of the page's properties, keyed by property name or ID. A page whose parent is a data source must use that data source's schema; a page whose parent is another page has only `title`. |
  | `icon`                                                         | [Icon](#icon)                                  | The page's icon.                                                                                                                                                                                  |
  | `cover`                                                        | [Cover](#cover)                                | The page's cover image.                                                                                                                                                                           |
  | `children`                                                     | [Block](#block)\[]                             | The content of the new page, as blocks. At most 100, and at most two levels of nesting — append the rest afterwards. <span className="field-constraints">max 100 items</span>                     |
  | `content`                                                      | [Block](#block)\[]                             | An alias for `children`. Send one or the other, not both. <span className="field-constraints">max 100 items</span>                                                                                |
  | `markdown`                                                     | `string`                                       | The content of the new page as Notion-flavored Markdown, which Notion parses into blocks. Newlines must be `\n`.                                                                                  |
  | `template`                                                     | [Template](#template)                          | A template to build the page from. Applying one is incompatible with supplying content directly.                                                                                                  |
  | `position`                                                     | [Position](#position)                          | Where the content is placed within the page.                                                                                                                                                      |
  | `allowAsync`                                                   | `boolean`                                      | Whether a large `markdown` body may be parsed in the background. When true the call answers 202 with an async task to poll rather than the finished page.                                         |
</div>

## Parent

What an object lives under.

<div className="reference-table">
  | Field          | Type     | Description                                                                                                                                                                                                         |
  | -------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
  | `type`         | `string` | The type of the parent. One of `database_id`, `data_source_id`, `page_id`, `workspace`, `block_id`, `agent_id`.                                                                                                     |
  | `dataSourceId` | `string` | The ID of the data source this object belongs to. This is the parent a page in a database takes.                                                                                                                    |
  | `databaseId`   | `string` | The ID of the database. On a data source's parent this is the database that contains it. As a page's parent it is the pre-2025-09-03 spelling: prefer `data_source_id`, which names the table the page is a row of. |
  | `pageId`       | `string` | The ID of the parent page.                                                                                                                                                                                          |
  | `blockId`      | `string` | The ID of the parent block.                                                                                                                                                                                         |
</div>

## PagePropertyValue

One entry in a page's `properties` map.

<div className="reference-table">
  | Field          | Type                                    | Description                                                                                                                                                                                                                         |
  | -------------- | --------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
  | `type`         | `string`                                | The type of this property value. Returned on a read; on a write Notion infers it from whichever field below is set.                                                                                                                 |
  | `title`        | [RichText](#richtext)\[]                | The page's title, as rich text. Every page has exactly one title property, and it is the only property a page outside a database has. <span className="field-constraints">max 100 items</span>                                      |
  | `richText`     | [RichText](#richtext)\[]                | A text property, as rich text. <span className="field-constraints">max 100 items</span>                                                                                                                                             |
  | `number`       | `number`                                | A number. Send null to clear it.                                                                                                                                                                                                    |
  | `select`       | [SelectValue](#selectvalue)             | The chosen option of a select property. Send null to clear it.                                                                                                                                                                      |
  | `multiSelect`  | [SelectValue](#selectvalue)\[]          | The chosen options of a multi-select property. <span className="field-constraints">max 100 items</span>                                                                                                                             |
  | `status`       | [StatusValue](#statusvalue)             | The current status of the page.                                                                                                                                                                                                     |
  | `date`         | [DateValue](#datevalue)                 | A date or date range. Send null to clear it.                                                                                                                                                                                        |
  | `people`       | [PartialUser](#partialuser)\[]          | The users assigned to a people property. <span className="field-constraints">max 100 items</span>                                                                                                                                   |
  | `files`        | [FileObject](#fileobject)\[]            | The files attached to a files property. An `external` entry must carry a `name`. Sending this replaces the whole list rather than adding to it. <span className="field-constraints">max 100 items</span>                            |
  | `checkbox`     | `boolean`                               | Whether a checkbox is checked.                                                                                                                                                                                                      |
  | `url`          | `string`                                | A URL. Maximum 2000 characters. <span className="field-constraints">max length 2000</span>                                                                                                                                          |
  | `email`        | `string`                                | An email address. Maximum 200 characters. <span className="field-constraints">max length 200</span>                                                                                                                                 |
  | `phoneNumber`  | `string`                                | A phone number. No structure is enforced, so any string up to 200 characters is accepted. <span className="field-constraints">max length 200</span>                                                                                 |
  | `relation`     | [RelationRef](#relationref)\[]          | The related pages. At most 100 may be sent or read in one request; a relation holding more reports `has_more` and is read in full through the page property item endpoint. <span className="field-constraints">max 100 items</span> |
  | `verification` | [VerificationValue](#verificationvalue) | The verification state of a page in a wiki database.                                                                                                                                                                                |
</div>

## RichText

One run of styled text.

<div className="reference-table">
  | Field         | Type                                | Description                                                                                          |
  | ------------- | ----------------------------------- | ---------------------------------------------------------------------------------------------------- |
  | `type`        | `"text" \| "mention" \| "equation"` | The type of this rich text object.                                                                   |
  | `text`        | [TextContent](#textcontent)         | The literal text, present when `type` is `text`.                                                     |
  | `mention`     | [Mention](#mention)                 | An inline mention of a user, page, database, date or link preview, present when `type` is `mention`. |
  | `equation`    | [EquationContent](#equationcontent) | An inline LaTeX equation, present when `type` is `equation`.                                         |
  | `annotations` | [Annotations](#annotations)         | The styling applied to this run of text.                                                             |
</div>

## TextContent

A literal run of text.

<div className="reference-table">
  | Field                                                           | Type                  | Description                                                                                                                                                                          |
  | --------------------------------------------------------------- | --------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
  | `content` <span className="required" title="required">\*</span> | `string`              | The actual text content of the text. Maximum 2000 characters; longer text must be split across several rich text objects. <span className="field-constraints">max length 2000</span> |
  | `link`                                                          | [TextLink](#textlink) | An object with information about any inline link in this text, if included. Null when the text is not a link.                                                                        |
</div>

## TextLink

The link on a text run.

<div className="reference-table">
  | Field                                                       | Type     | Description                                                                                                     |
  | ----------------------------------------------------------- | -------- | --------------------------------------------------------------------------------------------------------------- |
  | `url` <span className="required" title="required">\*</span> | `string` | The URL this text links to. Maximum 2000 characters. <span className="field-constraints">max length 2000</span> |
</div>

## Mention

An inline reference to something else in the workspace.

<div className="reference-table">
  | Field             | Type                                | Description                                                                                                    |
  | ----------------- | ----------------------------------- | -------------------------------------------------------------------------------------------------------------- |
  | `type`            | `string`                            | The type of the inline mention. One of `user`, `page`, `database`, `date`, `link_preview`, `template_mention`. |
  | `user`            | [PartialUser](#partialuser)         | The mentioned user.                                                                                            |
  | `page`            | [PageRef](#pageref)                 | The mentioned page.                                                                                            |
  | `database`        | [DatabaseRef](#databaseref)         | The mentioned database.                                                                                        |
  | `date`            | [DateValue](#datevalue)             | The mentioned date.                                                                                            |
  | `linkPreview`     | [LinkPreviewRef](#linkpreviewref)   | The mentioned link preview.                                                                                    |
  | `templateMention` | [TemplateMention](#templatemention) | The template placeholder being mentioned.                                                                      |
</div>

## PartialUser

A user, referenced by ID.

<div className="reference-table">
  | Field                                                      | Type     | Description                                                                    |
  | ---------------------------------------------------------- | -------- | ------------------------------------------------------------------------------ |
  | `object`                                                   | `string` | Always `user`. <span className="field-constraints">defaults to `"user"`</span> |
  | `id` <span className="required" title="required">\*</span> | `string` | The ID of the user.                                                            |
</div>

## PageRef

A reference to a page by ID.

<div className="reference-table">
  | Field                                                      | Type     | Description         |
  | ---------------------------------------------------------- | -------- | ------------------- |
  | `id` <span className="required" title="required">\*</span> | `string` | The ID of the page. |
</div>

## DatabaseRef

A reference to a database by ID.

<div className="reference-table">
  | Field                                                      | Type     | Description             |
  | ---------------------------------------------------------- | -------- | ----------------------- |
  | `id` <span className="required" title="required">\*</span> | `string` | The ID of the database. |
</div>

## DateValue

A date, or a date range, with an optional time zone.

<div className="reference-table">
  | Field                                                         | Type     | Description                                                                                                                                                                                                     |
  | ------------------------------------------------------------- | -------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
  | `start` <span className="required" title="required">\*</span> | `string` | An ISO 8601 format date, with optional time. A date without a time (`2024-05-01`) and a datetime (`2024-05-01T10:00:00-04:00`) are both accepted.                                                               |
  | `end`                                                         | `string` | An ISO 8601 formatted date, with optional time. Null if this is not a range.                                                                                                                                    |
  | `timeZone`                                                    | `string` | Time zone information for `start` and `end`, as an IANA database name such as `America/New_York`. When set, `start` and `end` must not carry their own UTC offset. Null when the dates carry their own offsets. |
</div>

## LinkPreviewRef

A mention of a third-party URL that Notion renders as a preview.

<div className="reference-table">
  | Field                                                       | Type     | Description                                                                             |
  | ----------------------------------------------------------- | -------- | --------------------------------------------------------------------------------------- |
  | `url` <span className="required" title="required">\*</span> | `string` | The URL of the link preview. <span className="field-constraints">max length 2000</span> |
</div>

## TemplateMention

A placeholder that resolves when a template is instantiated.

<div className="reference-table">
  | Field                 | Type                                                 | Description                                 |
  | --------------------- | ---------------------------------------------------- | ------------------------------------------- |
  | `type`                | `"template_mention_date" \| "template_mention_user"` | The type of the template mention.           |
  | `templateMentionDate` | `"today" \| "now"`                                   | Resolves to the date the template is used.  |
  | `templateMentionUser` | `string`                                             | Resolves to the user who uses the template. |
</div>

## EquationContent

An inline LaTeX equation.

<div className="reference-table">
  | Field                                                              | Type     | Description                                                                                                                            |
  | ------------------------------------------------------------------ | -------- | -------------------------------------------------------------------------------------------------------------------------------------- |
  | `expression` <span className="required" title="required">\*</span> | `string` | The LaTeX string representing the inline equation. Maximum 1000 characters. <span className="field-constraints">max length 1000</span> |
</div>

## Annotations

The styling applied to one run of rich text.

<div className="reference-table">
  | Field           | Type                        | Description                                                                                                                   |
  | --------------- | --------------------------- | ----------------------------------------------------------------------------------------------------------------------------- |
  | `bold`          | `boolean`                   | Whether the text is bolded.                                                                                                   |
  | `italic`        | `boolean`                   | Whether the text is italicized.                                                                                               |
  | `strikethrough` | `boolean`                   | Whether the text is struck through.                                                                                           |
  | `underline`     | `boolean`                   | Whether the text is underlined.                                                                                               |
  | `code`          | `boolean`                   | Whether the text is code style.                                                                                               |
  | `color`         | [NotionColor](#notioncolor) | Color of the text. Possible values include the ten hues as text colors and again as `_background` highlights, plus `default`. |
</div>

## SelectValue

One chosen option of a select or multi-select property.

<div className="reference-table">
  | Field  | Type     | Description                                                                                                                           |
  | ------ | -------- | ------------------------------------------------------------------------------------------------------------------------------------- |
  | `id`   | `string` | The ID of the option. Use this or `name`, not both.                                                                                   |
  | `name` | `string` | The name of the option as it appears in Notion. Commas are not valid in a select value. An option that does not exist yet is created. |
</div>

## StatusValue

The current status of a page in a status property.

<div className="reference-table">
  | Field  | Type     | Description                                                                             |
  | ------ | -------- | --------------------------------------------------------------------------------------- |
  | `id`   | `string` | The ID of the status option. Use this or `name`, not both.                              |
  | `name` | `string` | The name of the status option. It must already exist on the database's status property. |
</div>

## FileObject

A file, either linked externally or hosted by Notion.

<div className="reference-table">
  | Field        | Type                                    | Description                                                                                                                                                                |
  | ------------ | --------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
  | `type`       | `"external" \| "file" \| "file_upload"` | The type of this file object.                                                                                                                                              |
  | `external`   | [ExternalFileData](#externalfiledata)   | A file hosted somewhere else, referenced by URL.                                                                                                                           |
  | `fileUpload` | [FileUploadRef](#fileuploadref)         | A completed file upload to attach, referenced by its ID.                                                                                                                   |
  | `name`       | `string`                                | The name of the file, as shown in Notion. Required for an `external` entry in a files property; optional for a `file_upload`, which carries the name it was uploaded with. |
</div>

## ExternalFileData

A file Notion links to but does not host.

<div className="reference-table">
  | Field                                                       | Type     | Description                                                                                                                                                                                  |
  | ----------------------------------------------------------- | -------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
  | `url` <span className="required" title="required">\*</span> | `string` | A link to the externally hosted content. Maximum 2000 characters. Notion does not copy the file, so the link must stay reachable. <span className="field-constraints">max length 2000</span> |
</div>

## FileUploadRef

A completed file upload, by ID.

<div className="reference-table">
  | Field                                                      | Type     | Description                               |
  | ---------------------------------------------------------- | -------- | ----------------------------------------- |
  | `id` <span className="required" title="required">\*</span> | `string` | The ID of a completed File Upload object. |
</div>

## RelationRef

One related page, referenced by ID.

<div className="reference-table">
  | Field                                                      | Type     | Description                 |
  | ---------------------------------------------------------- | -------- | --------------------------- |
  | `id` <span className="required" title="required">\*</span> | `string` | The ID of the related page. |
</div>

## VerificationValue

The verification state of a page in a wiki database.

<div className="reference-table">
  | Field                                                         | Type                                      | Description                                                                                                                                     |
  | ------------------------------------------------------------- | ----------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------- |
  | `state` <span className="required" title="required">\*</span> | `"verified" \| "unverified" \| "expired"` | The verification state of the page. `expired` is a state Notion moves a page into when its verification lapses; set `verified` or `unverified`. |
  | `date`                                                        | [DateValue](#datevalue)                   | The date the page was verified and the date the verification expires. Only meaningful when `state` is `verified`.                               |
</div>

## Icon

A page, database or callout icon.

<div className="reference-table">
  | Field         | Type                                  | Description                                                                               |
  | ------------- | ------------------------------------- | ----------------------------------------------------------------------------------------- |
  | `type`        | `string`                              | The type of this icon. One of `emoji`, `external`, `file_upload`, `custom_emoji`, `icon`. |
  | `emoji`       | `string`                              | A standard emoji character, for example `🥬`.                                             |
  | `external`    | [ExternalFileData](#externalfiledata) | An externally hosted image, referenced by URL.                                            |
  | `fileUpload`  | [FileUploadRef](#fileuploadref)       | A completed file upload to use as the icon.                                               |
  | `customEmoji` | [CustomEmojiData](#customemojidata)   | One of the workspace's own uploaded emoji.                                                |
  | `icon`        | [NotionIconData](#notionicondata)     | One of Notion's own built-in icons.                                                       |
</div>

## CustomEmojiData

A workspace's own uploaded emoji.

<div className="reference-table">
  | Field                                                      | Type     | Description                 |
  | ---------------------------------------------------------- | -------- | --------------------------- |
  | `id` <span className="required" title="required">\*</span> | `string` | The ID of the custom emoji. |
</div>

## NotionIconData

One of Notion's own built-in icons.

<div className="reference-table">
  | Field                                                        | Type     | Description                           |
  | ------------------------------------------------------------ | -------- | ------------------------------------- |
  | `name` <span className="required" title="required">\*</span> | `string` | The name of the built-in Notion icon. |
  | `color`                                                      | `string` | The color applied to the icon.        |
</div>

## Cover

A page or database cover image.

<div className="reference-table">
  | Field        | Type                                  | Description                                    |
  | ------------ | ------------------------------------- | ---------------------------------------------- |
  | `type`       | `"external" \| "file_upload"`         | The type of this cover.                        |
  | `external`   | [ExternalFileData](#externalfiledata) | An externally hosted image, referenced by URL. |
  | `fileUpload` | [FileUploadRef](#fileuploadref)       | A completed file upload to use as the cover.   |
</div>

## Block

One piece of content on a page.

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

## CodeContent

A code block.

<div className="reference-table">
  | Field                                                            | Type                          | Description                                                                                  |
  | ---------------------------------------------------------------- | ----------------------------- | -------------------------------------------------------------------------------------------- |
  | `richText` <span className="required" title="required">\*</span> | [RichText](#richtext)\[]      | The code, as rich text. <span className="field-constraints">max 100 items</span>             |
  | `language` <span className="required" title="required">\*</span> | [CodeLanguage](#codelanguage) | The language the code is highlighted as.                                                     |
  | `caption`                                                        | [RichText](#richtext)\[]      | The caption shown beneath the code. <span className="field-constraints">max 100 items</span> |
</div>

## EquationBlockContent

A standalone LaTeX equation, as its own block.

<div className="reference-table">
  | Field                                                              | Type     | Description                |
  | ------------------------------------------------------------------ | -------- | -------------------------- |
  | `expression` <span className="required" title="required">\*</span> | `string` | A KaTeX compatible string. |
</div>

## MediaContent

A file Notion embeds — an image, a video, an audio clip, a PDF or a file.

<div className="reference-table">
  | Field        | Type                                    | Description                                                                                   |
  | ------------ | --------------------------------------- | --------------------------------------------------------------------------------------------- |
  | `type`       | `"external" \| "file" \| "file_upload"` | Where the file comes from.                                                                    |
  | `external`   | [ExternalFileData](#externalfiledata)   | A file hosted elsewhere, referenced by URL.                                                   |
  | `fileUpload` | [FileUploadRef](#fileuploadref)         | A completed file upload to attach, referenced by its ID.                                      |
  | `caption`    | [RichText](#richtext)\[]                | The caption shown beneath the media. <span className="field-constraints">max 100 items</span> |
</div>

## FileBlockContent

A file attachment, which unlike other media carries a display name.

<div className="reference-table">
  | Field        | Type                                    | Description                                                                                         |
  | ------------ | --------------------------------------- | --------------------------------------------------------------------------------------------------- |
  | `type`       | `"external" \| "file" \| "file_upload"` | Where the file comes from.                                                                          |
  | `external`   | [ExternalFileData](#externalfiledata)   | A file hosted elsewhere, referenced by URL.                                                         |
  | `fileUpload` | [FileUploadRef](#fileuploadref)         | A completed file upload to attach, referenced by its ID.                                            |
  | `caption`    | [RichText](#richtext)\[]                | The caption shown beneath the media. <span className="field-constraints">max 100 items</span>       |
  | `name`       | `string`                                | The name of the file, as shown in Notion. <span className="field-constraints">max length 100</span> |
</div>

## EmbedContent

Third-party content rendered inline.

<div className="reference-table">
  | Field        | Type                            | Description                                                                                |
  | ------------ | ------------------------------- | ------------------------------------------------------------------------------------------ |
  | `url`        | `string`                        | The link to the embedded content.                                                          |
  | `fileUpload` | [FileUploadRef](#fileuploadref) | A completed file upload to embed. An uploaded `.html` file becomes an HTML embed.          |
  | `caption`    | [RichText](#richtext)\[]        | The caption shown with the embed. <span className="field-constraints">max 100 items</span> |
</div>

## BookmarkContent

A link rendered as a bookmark card.

<div className="reference-table">
  | Field                                                       | Type                     | Description                                                                                   |
  | ----------------------------------------------------------- | ------------------------ | --------------------------------------------------------------------------------------------- |
  | `url` <span className="required" title="required">\*</span> | `string`                 | The link this bookmark points to.                                                             |
  | `caption`                                                   | [RichText](#richtext)\[] | The caption shown with the bookmark. <span className="field-constraints">max 100 items</span> |
</div>

## EmptyContent

A block with no content of its own — a divider or a breadcrumb.

This object has no settable fields.

## TableOfContentsContent

A table of contents, built from the page's headings.

<div className="reference-table">
  | Field   | Type                        | Description             |
  | ------- | --------------------------- | ----------------------- |
  | `color` | [NotionColor](#notioncolor) | The color of the block. |
</div>

## TableRowContent

One row of a table.

<div className="reference-table">
  | Field                                                         | Type             | Description                                                                                                                  |
  | ------------------------------------------------------------- | ---------------- | ---------------------------------------------------------------------------------------------------------------------------- |
  | `cells` <span className="required" title="required">\*</span> | `RichText`\[]\[] | The row's cells, left to right, each an array of rich text. The number of cells must equal the parent table's `table_width`. |
</div>

## LinkToPageContent

A link to another page, database or comment in the workspace.

<div className="reference-table">
  | Field        | Type                                         | Description                      |
  | ------------ | -------------------------------------------- | -------------------------------- |
  | `type`       | `"page_id" \| "database_id" \| "comment_id"` | What kind of thing is linked to. |
  | `pageId`     | `string`                                     | The ID of the linked page.       |
  | `databaseId` | `string`                                     | The ID of the linked database.   |
  | `commentId`  | `string`                                     | The ID of the linked comment.    |
</div>

## BlockParagraphContent

A top-level paragraph.

<div className="reference-table">
  | Field                                                            | Type                           | Description                                                                                                                |
  | ---------------------------------------------------------------- | ------------------------------ | -------------------------------------------------------------------------------------------------------------------------- |
  | `richText` <span className="required" title="required">\*</span> | [RichText](#richtext)\[]       | The rich text displayed in the block. <span className="field-constraints">max 100 items</span>                             |
  | `color`                                                          | [NotionColor](#notioncolor)    | The color of the block.                                                                                                    |
  | `icon`                                                           | [Icon](#icon)                  | An icon shown beside the paragraph. Used when the paragraph is the direct child of a `tab` block, where it labels the tab. |
  | `children`                                                       | [NestedBlock](#nestedblock)\[] | The nested child blocks. At most 100. <span className="field-constraints">max 100 items</span>                             |
</div>

## NestedBlock

A block one level down from the top.

<div className="reference-table">
  | Field              | Type                                                            | Description                                                                                                       |
  | ------------------ | --------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------- |
  | `object`           | `string`                                                        | Always `block`.                                                                                                   |
  | `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](#codecontent)                                     | A block of code.                                                                                                  |
  | `equation`         | [EquationBlockContent](#equationblockcontent)                   | A standalone LaTeX equation.                                                                                      |
  | `image`            | [MediaContent](#mediacontent)                                   | An image.                                                                                                         |
  | `video`            | [MediaContent](#mediacontent)                                   | A video.                                                                                                          |
  | `audio`            | [MediaContent](#mediacontent)                                   | An audio clip.                                                                                                    |
  | `pdf`              | [MediaContent](#mediacontent)                                   | A PDF.                                                                                                            |
  | `file`             | [FileBlockContent](#fileblockcontent)                           | A file attachment.                                                                                                |
  | `embed`            | [EmbedContent](#embedcontent)                                   | Third-party content rendered inline.                                                                              |
  | `bookmark`         | [BookmarkContent](#bookmarkcontent)                             | A link rendered as a bookmark card.                                                                               |
  | `divider`          | [EmptyContent](#emptycontent)                                   | A horizontal rule. Send an empty object.                                                                          |
  | `breadcrumb`       | [EmptyContent](#emptycontent)                                   | The page's ancestry. Send an empty object.                                                                        |
  | `tableOfContents`  | [TableOfContentsContent](#tableofcontentscontent)               | A table of contents built from the page's headings.                                                               |
  | `tableRow`         | [TableRowContent](#tablerowcontent)                             | One row of a table.                                                                                               |
  | `linkToPage`       | [LinkToPageContent](#linktopagecontent)                         | A link to another page, database or comment.                                                                      |
  | `paragraph`        | [NestedParagraphContent](#nestedparagraphcontent)               | A paragraph of text.                                                                                              |
  | `heading1`         | [NestedHeadingContent](#nestedheadingcontent)                   | A top-level heading.                                                                                              |
  | `heading2`         | [NestedHeadingContent](#nestedheadingcontent)                   | A second-level heading.                                                                                           |
  | `heading3`         | [NestedHeadingContent](#nestedheadingcontent)                   | A third-level heading.                                                                                            |
  | `heading4`         | [NestedHeadingContent](#nestedheadingcontent)                   | A fourth-level heading.                                                                                           |
  | `bulletedListItem` | [NestedTextBlockContent](#nestedtextblockcontent)               | A bulleted list item.                                                                                             |
  | `numberedListItem` | [NestedNumberedListItemContent](#nestednumberedlistitemcontent) | A numbered list item.                                                                                             |
  | `toDo`             | [NestedToDoContent](#nestedtodocontent)                         | A checklist item.                                                                                                 |
  | `toggle`           | [NestedTextBlockContent](#nestedtextblockcontent)               | A toggle, which collapses the blocks beneath it.                                                                  |
  | `quote`            | [NestedTextBlockContent](#nestedtextblockcontent)               | A quotation.                                                                                                      |
  | `callout`          | [NestedCalloutContent](#nestedcalloutcontent)                   | A callout — text in a tinted box with an icon.                                                                    |
  | `template`         | [NestedTemplateContent](#nestedtemplatecontent)                 | A template button. Deprecated by Notion.                                                                          |
  | `syncedBlock`      | [NestedSyncedBlockContent](#nestedsyncedblockcontent)           | Content mirrored between two places.                                                                              |
  | `tab`              | [NestedTabContent](#nestedtabcontent)                           | A set of tabs.                                                                                                    |
  | `table`            | [NestedTableContent](#nestedtablecontent)                       | A table.                                                                                                          |
</div>

## NestedParagraphContent

A paragraph one level down.

<div className="reference-table">
  | Field                                                            | Type                        | Description                                                                                                                |
  | ---------------------------------------------------------------- | --------------------------- | -------------------------------------------------------------------------------------------------------------------------- |
  | `richText` <span className="required" title="required">\*</span> | [RichText](#richtext)\[]    | The rich text displayed in the block. <span className="field-constraints">max 100 items</span>                             |
  | `color`                                                          | [NotionColor](#notioncolor) | The color of the block.                                                                                                    |
  | `icon`                                                           | [Icon](#icon)               | An icon shown beside the paragraph. Used when the paragraph is the direct child of a `tab` block, where it labels the tab. |
  | `children`                                                       | [LeafBlock](#leafblock)\[]  | The nested child blocks. At most 100. <span className="field-constraints">max 100 items</span>                             |
</div>

## LeafBlock

A block two levels down, which is as deep as one request goes.

<div className="reference-table">
  | Field              | Type                                                | Description                                                                                                       |
  | ------------------ | --------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------- |
  | `object`           | `string`                                            | Always `block`.                                                                                                   |
  | `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](#codecontent)                         | A block of code.                                                                                                  |
  | `equation`         | [EquationBlockContent](#equationblockcontent)       | A standalone LaTeX equation.                                                                                      |
  | `image`            | [MediaContent](#mediacontent)                       | An image.                                                                                                         |
  | `video`            | [MediaContent](#mediacontent)                       | A video.                                                                                                          |
  | `audio`            | [MediaContent](#mediacontent)                       | An audio clip.                                                                                                    |
  | `pdf`              | [MediaContent](#mediacontent)                       | A PDF.                                                                                                            |
  | `file`             | [FileBlockContent](#fileblockcontent)               | A file attachment.                                                                                                |
  | `embed`            | [EmbedContent](#embedcontent)                       | Third-party content rendered inline.                                                                              |
  | `bookmark`         | [BookmarkContent](#bookmarkcontent)                 | A link rendered as a bookmark card.                                                                               |
  | `divider`          | [EmptyContent](#emptycontent)                       | A horizontal rule. Send an empty object.                                                                          |
  | `breadcrumb`       | [EmptyContent](#emptycontent)                       | The page's ancestry. Send an empty object.                                                                        |
  | `tableOfContents`  | [TableOfContentsContent](#tableofcontentscontent)   | A table of contents built from the page's headings.                                                               |
  | `tableRow`         | [TableRowContent](#tablerowcontent)                 | One row of a table.                                                                                               |
  | `linkToPage`       | [LinkToPageContent](#linktopagecontent)             | A link to another page, database or comment.                                                                      |
  | `paragraph`        | [ParagraphContent](#paragraphcontent)               | A paragraph of text.                                                                                              |
  | `heading1`         | [HeadingContent](#headingcontent)                   | A top-level heading.                                                                                              |
  | `heading2`         | [HeadingContent](#headingcontent)                   | A second-level heading.                                                                                           |
  | `heading3`         | [HeadingContent](#headingcontent)                   | A third-level heading.                                                                                            |
  | `heading4`         | [HeadingContent](#headingcontent)                   | A fourth-level heading.                                                                                           |
  | `bulletedListItem` | [TextBlockContent](#textblockcontent)               | A bulleted list item.                                                                                             |
  | `numberedListItem` | [NumberedListItemContent](#numberedlistitemcontent) | A numbered list item.                                                                                             |
  | `toDo`             | [ToDoContent](#todocontent)                         | A checklist item.                                                                                                 |
  | `toggle`           | [TextBlockContent](#textblockcontent)               | A toggle, which collapses the blocks beneath it.                                                                  |
  | `quote`            | [TextBlockContent](#textblockcontent)               | A quotation.                                                                                                      |
  | `callout`          | [CalloutContent](#calloutcontent)                   | A callout — text in a tinted box with an icon.                                                                    |
  | `template`         | [TemplateContent](#templatecontent)                 | A template button. Deprecated by Notion.                                                                          |
  | `syncedBlock`      | [SyncedBlockContent](#syncedblockcontent)           | Content mirrored between two places.                                                                              |
  | `tab`              | [TabContent](#tabcontent)                           | A set of tabs.                                                                                                    |
</div>

## ParagraphContent

A paragraph of rich text.

<div className="reference-table">
  | Field                                                            | Type                        | Description                                                                                                                |
  | ---------------------------------------------------------------- | --------------------------- | -------------------------------------------------------------------------------------------------------------------------- |
  | `richText` <span className="required" title="required">\*</span> | [RichText](#richtext)\[]    | The rich text displayed in the block. <span className="field-constraints">max 100 items</span>                             |
  | `color`                                                          | [NotionColor](#notioncolor) | The color of the block.                                                                                                    |
  | `icon`                                                           | [Icon](#icon)               | An icon shown beside the paragraph. Used when the paragraph is the direct child of a `tab` block, where it labels the tab. |
</div>

## HeadingContent

A heading, optionally collapsible.

<div className="reference-table">
  | Field                                                            | Type                        | Description                                                                                                      |
  | ---------------------------------------------------------------- | --------------------------- | ---------------------------------------------------------------------------------------------------------------- |
  | `richText` <span className="required" title="required">\*</span> | [RichText](#richtext)\[]    | The rich text displayed in the block. <span className="field-constraints">max 100 items</span>                   |
  | `color`                                                          | [NotionColor](#notioncolor) | The color of the block.                                                                                          |
  | `isToggleable`                                                   | `boolean`                   | Whether the heading collapses to hide the blocks beneath it. A heading can only have children when this is true. |
</div>

## TextBlockContent

Rich text with a colour.

<div className="reference-table">
  | Field                                                            | Type                        | Description                                                                                    |
  | ---------------------------------------------------------------- | --------------------------- | ---------------------------------------------------------------------------------------------- |
  | `richText` <span className="required" title="required">\*</span> | [RichText](#richtext)\[]    | The rich text displayed in the block. <span className="field-constraints">max 100 items</span> |
  | `color`                                                          | [NotionColor](#notioncolor) | The color of the block.                                                                        |
</div>

## NumberedListItemContent

A numbered list item.

<div className="reference-table">
  | Field                                                            | Type                        | Description                                                                                    |
  | ---------------------------------------------------------------- | --------------------------- | ---------------------------------------------------------------------------------------------- |
  | `richText` <span className="required" title="required">\*</span> | [RichText](#richtext)\[]    | The rich text displayed in the block. <span className="field-constraints">max 100 items</span> |
  | `color`                                                          | [NotionColor](#notioncolor) | The color of the block.                                                                        |
</div>

## ToDoContent

A checklist item.

<div className="reference-table">
  | Field                                                            | Type                        | Description                                                                                    |
  | ---------------------------------------------------------------- | --------------------------- | ---------------------------------------------------------------------------------------------- |
  | `richText` <span className="required" title="required">\*</span> | [RichText](#richtext)\[]    | The rich text displayed in the block. <span className="field-constraints">max 100 items</span> |
  | `color`                                                          | [NotionColor](#notioncolor) | The color of the block.                                                                        |
  | `checked`                                                        | `boolean`                   | Whether the to-do is checked. Unchecked when absent.                                           |
</div>

## CalloutContent

A callout — rich text in a tinted box with an icon.

<div className="reference-table">
  | Field                                                            | Type                        | Description                                                                                    |
  | ---------------------------------------------------------------- | --------------------------- | ---------------------------------------------------------------------------------------------- |
  | `richText` <span className="required" title="required">\*</span> | [RichText](#richtext)\[]    | The rich text displayed in the block. <span className="field-constraints">max 100 items</span> |
  | `color`                                                          | [NotionColor](#notioncolor) | The color of the block.                                                                        |
  | `icon`                                                           | [Icon](#icon)               | The icon shown in the callout.                                                                 |
</div>

## TemplateContent

A template button and the blocks it duplicates.

<div className="reference-table">
  | Field                                                            | Type                     | Description                                                                                |
  | ---------------------------------------------------------------- | ------------------------ | ------------------------------------------------------------------------------------------ |
  | `richText` <span className="required" title="required">\*</span> | [RichText](#richtext)\[] | The title of the template button. <span className="field-constraints">max 100 items</span> |
</div>

## SyncedBlockContent

Content that appears in more than one place and stays in step.

<div className="reference-table">
  | Field                                                              | Type                            | Description                                                                                         |
  | ------------------------------------------------------------------ | ------------------------------- | --------------------------------------------------------------------------------------------------- |
  | `syncedFrom` <span className="required" title="required">\*</span> | [SyncedFromRef](#syncedfromref) | The original this block mirrors, or null if this block is itself the original. Required either way. |
</div>

## SyncedFromRef

The original block a duplicate synced block mirrors.

<div className="reference-table">
  | Field                                                           | Type     | Description                          |
  | --------------------------------------------------------------- | -------- | ------------------------------------ |
  | `type`                                                          | `string` | Always `block_id`.                   |
  | `blockId` <span className="required" title="required">\*</span> | `string` | The ID of the original synced block. |
</div>

## TabContent

A set of tabs, whose children are the tabs themselves.

This object has no settable fields.

## NestedHeadingContent

A heading one level down.

<div className="reference-table">
  | Field                                                            | Type                        | Description                                                                                                              |
  | ---------------------------------------------------------------- | --------------------------- | ------------------------------------------------------------------------------------------------------------------------ |
  | `richText` <span className="required" title="required">\*</span> | [RichText](#richtext)\[]    | The rich text displayed in the block. <span className="field-constraints">max 100 items</span>                           |
  | `color`                                                          | [NotionColor](#notioncolor) | The color of the block.                                                                                                  |
  | `isToggleable`                                                   | `boolean`                   | Whether the heading collapses to hide the blocks beneath it. A heading can only have children when this is true.         |
  | `children`                                                       | [LeafBlock](#leafblock)\[]  | The blocks the heading collapses, when `is_toggleable` is true. <span className="field-constraints">max 100 items</span> |
</div>

## NestedTextBlockContent

A list item, quote or toggle one level down.

<div className="reference-table">
  | Field                                                            | Type                        | Description                                                                                    |
  | ---------------------------------------------------------------- | --------------------------- | ---------------------------------------------------------------------------------------------- |
  | `richText` <span className="required" title="required">\*</span> | [RichText](#richtext)\[]    | The rich text displayed in the block. <span className="field-constraints">max 100 items</span> |
  | `color`                                                          | [NotionColor](#notioncolor) | The color of the block.                                                                        |
  | `children`                                                       | [LeafBlock](#leafblock)\[]  | The nested child blocks. At most 100. <span className="field-constraints">max 100 items</span> |
</div>

## NestedNumberedListItemContent

A numbered list item one level down.

<div className="reference-table">
  | Field                                                            | Type                        | Description                                                                                    |
  | ---------------------------------------------------------------- | --------------------------- | ---------------------------------------------------------------------------------------------- |
  | `richText` <span className="required" title="required">\*</span> | [RichText](#richtext)\[]    | The rich text displayed in the block. <span className="field-constraints">max 100 items</span> |
  | `color`                                                          | [NotionColor](#notioncolor) | The color of the block.                                                                        |
  | `children`                                                       | [LeafBlock](#leafblock)\[]  | The nested child blocks. At most 100. <span className="field-constraints">max 100 items</span> |
</div>

## NestedToDoContent

A checklist item one level down.

<div className="reference-table">
  | Field                                                            | Type                        | Description                                                                                    |
  | ---------------------------------------------------------------- | --------------------------- | ---------------------------------------------------------------------------------------------- |
  | `richText` <span className="required" title="required">\*</span> | [RichText](#richtext)\[]    | The rich text displayed in the block. <span className="field-constraints">max 100 items</span> |
  | `color`                                                          | [NotionColor](#notioncolor) | The color of the block.                                                                        |
  | `checked`                                                        | `boolean`                   | Whether the to-do is checked. Unchecked when absent.                                           |
  | `children`                                                       | [LeafBlock](#leafblock)\[]  | The nested child blocks. At most 100. <span className="field-constraints">max 100 items</span> |
</div>

## NestedCalloutContent

A callout one level down.

<div className="reference-table">
  | Field                                                            | Type                        | Description                                                                                    |
  | ---------------------------------------------------------------- | --------------------------- | ---------------------------------------------------------------------------------------------- |
  | `richText` <span className="required" title="required">\*</span> | [RichText](#richtext)\[]    | The rich text displayed in the block. <span className="field-constraints">max 100 items</span> |
  | `color`                                                          | [NotionColor](#notioncolor) | The color of the block.                                                                        |
  | `icon`                                                           | [Icon](#icon)               | The icon shown in the callout.                                                                 |
  | `children`                                                       | [LeafBlock](#leafblock)\[]  | The nested child blocks. At most 100. <span className="field-constraints">max 100 items</span> |
</div>

## NestedTemplateContent

A template button one level down.

<div className="reference-table">
  | Field                                                            | Type                       | Description                                                                                |
  | ---------------------------------------------------------------- | -------------------------- | ------------------------------------------------------------------------------------------ |
  | `richText` <span className="required" title="required">\*</span> | [RichText](#richtext)\[]   | The title of the template button. <span className="field-constraints">max 100 items</span> |
  | `children`                                                       | [LeafBlock](#leafblock)\[] | The blocks the button duplicates. <span className="field-constraints">max 100 items</span> |
</div>

## NestedSyncedBlockContent

A synced block one level down.

<div className="reference-table">
  | Field                                                              | Type                            | Description                                                                                                                  |
  | ------------------------------------------------------------------ | ------------------------------- | ---------------------------------------------------------------------------------------------------------------------------- |
  | `syncedFrom` <span className="required" title="required">\*</span> | [SyncedFromRef](#syncedfromref) | The original this block mirrors, or null if this block is itself the original. Required either way.                          |
  | `children`                                                         | [LeafBlock](#leafblock)\[]      | The synced content. Only set on the original, never on a duplicate. <span className="field-constraints">max 100 items</span> |
</div>

## NestedTabContent

A set of tabs one level down.

<div className="reference-table">
  | Field                                                            | Type                       | Description                                                                                                                |
  | ---------------------------------------------------------------- | -------------------------- | -------------------------------------------------------------------------------------------------------------------------- |
  | `children` <span className="required" title="required">\*</span> | [LeafBlock](#leafblock)\[] | The tabs, each a `paragraph` block labelling and holding one tab. <span className="field-constraints">max 100 items</span> |
</div>

## NestedTableContent

A table one level down.

<div className="reference-table">
  | Field                                                              | Type                       | Description                                                                                                                                    |
  | ------------------------------------------------------------------ | -------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------- |
  | `tableWidth` <span className="required" title="required">\*</span> | `integer`                  | The number of columns. Fixed at creation — an update cannot change it. <span className="field-constraints">≥ 1</span>                          |
  | `hasColumnHeader`                                                  | `boolean`                  | Whether the first row is styled as a header.                                                                                                   |
  | `hasRowHeader`                                                     | `boolean`                  | Whether the first column is styled as a header.                                                                                                |
  | `children` <span className="required" title="required">\*</span>   | [LeafBlock](#leafblock)\[] | The table's rows, each a `table_row` block whose `cells` count matches `table_width`. <span className="field-constraints">max 100 items</span> |
</div>

## BlockHeadingContent

A top-level heading.

<div className="reference-table">
  | Field                                                            | Type                           | Description                                                                                                              |
  | ---------------------------------------------------------------- | ------------------------------ | ------------------------------------------------------------------------------------------------------------------------ |
  | `richText` <span className="required" title="required">\*</span> | [RichText](#richtext)\[]       | The rich text displayed in the block. <span className="field-constraints">max 100 items</span>                           |
  | `color`                                                          | [NotionColor](#notioncolor)    | The color of the block.                                                                                                  |
  | `isToggleable`                                                   | `boolean`                      | Whether the heading collapses to hide the blocks beneath it. A heading can only have children when this is true.         |
  | `children`                                                       | [NestedBlock](#nestedblock)\[] | The blocks the heading collapses, when `is_toggleable` is true. <span className="field-constraints">max 100 items</span> |
</div>

## BlockTextContent

A top-level list item, quote or toggle.

<div className="reference-table">
  | Field                                                            | Type                           | Description                                                                                    |
  | ---------------------------------------------------------------- | ------------------------------ | ---------------------------------------------------------------------------------------------- |
  | `richText` <span className="required" title="required">\*</span> | [RichText](#richtext)\[]       | The rich text displayed in the block. <span className="field-constraints">max 100 items</span> |
  | `color`                                                          | [NotionColor](#notioncolor)    | The color of the block.                                                                        |
  | `children`                                                       | [NestedBlock](#nestedblock)\[] | The nested child blocks. At most 100. <span className="field-constraints">max 100 items</span> |
</div>

## BlockNumberedListItemContent

A top-level numbered list item.

<div className="reference-table">
  | Field                                                            | Type                           | Description                                                                                    |
  | ---------------------------------------------------------------- | ------------------------------ | ---------------------------------------------------------------------------------------------- |
  | `richText` <span className="required" title="required">\*</span> | [RichText](#richtext)\[]       | The rich text displayed in the block. <span className="field-constraints">max 100 items</span> |
  | `color`                                                          | [NotionColor](#notioncolor)    | The color of the block.                                                                        |
  | `children`                                                       | [NestedBlock](#nestedblock)\[] | The nested child blocks. At most 100. <span className="field-constraints">max 100 items</span> |
</div>

## BlockToDoContent

A top-level checklist item.

<div className="reference-table">
  | Field                                                            | Type                           | Description                                                                                    |
  | ---------------------------------------------------------------- | ------------------------------ | ---------------------------------------------------------------------------------------------- |
  | `richText` <span className="required" title="required">\*</span> | [RichText](#richtext)\[]       | The rich text displayed in the block. <span className="field-constraints">max 100 items</span> |
  | `color`                                                          | [NotionColor](#notioncolor)    | The color of the block.                                                                        |
  | `checked`                                                        | `boolean`                      | Whether the to-do is checked. Unchecked when absent.                                           |
  | `children`                                                       | [NestedBlock](#nestedblock)\[] | The nested child blocks. At most 100. <span className="field-constraints">max 100 items</span> |
</div>

## BlockCalloutContent

A top-level callout.

<div className="reference-table">
  | Field                                                            | Type                           | Description                                                                                    |
  | ---------------------------------------------------------------- | ------------------------------ | ---------------------------------------------------------------------------------------------- |
  | `richText` <span className="required" title="required">\*</span> | [RichText](#richtext)\[]       | The rich text displayed in the block. <span className="field-constraints">max 100 items</span> |
  | `color`                                                          | [NotionColor](#notioncolor)    | The color of the block.                                                                        |
  | `icon`                                                           | [Icon](#icon)                  | The icon shown in the callout.                                                                 |
  | `children`                                                       | [NestedBlock](#nestedblock)\[] | The nested child blocks. At most 100. <span className="field-constraints">max 100 items</span> |
</div>

## BlockTemplateContent

A top-level template button.

<div className="reference-table">
  | Field                                                            | Type                           | Description                                                                                |
  | ---------------------------------------------------------------- | ------------------------------ | ------------------------------------------------------------------------------------------ |
  | `richText` <span className="required" title="required">\*</span> | [RichText](#richtext)\[]       | The title of the template button. <span className="field-constraints">max 100 items</span> |
  | `children`                                                       | [NestedBlock](#nestedblock)\[] | The blocks the button duplicates. <span className="field-constraints">max 100 items</span> |
</div>

## BlockSyncedBlockContent

A top-level synced block.

<div className="reference-table">
  | Field                                                              | Type                            | Description                                                                                                                  |
  | ------------------------------------------------------------------ | ------------------------------- | ---------------------------------------------------------------------------------------------------------------------------- |
  | `syncedFrom` <span className="required" title="required">\*</span> | [SyncedFromRef](#syncedfromref) | The original this block mirrors, or null if this block is itself the original. Required either way.                          |
  | `children`                                                         | [NestedBlock](#nestedblock)\[]  | The synced content. Only set on the original, never on a duplicate. <span className="field-constraints">max 100 items</span> |
</div>

## BlockTabContent

A top-level set of tabs.

<div className="reference-table">
  | Field                                                            | Type                           | Description                                                                                                                |
  | ---------------------------------------------------------------- | ------------------------------ | -------------------------------------------------------------------------------------------------------------------------- |
  | `children` <span className="required" title="required">\*</span> | [NestedBlock](#nestedblock)\[] | The tabs, each a `paragraph` block labelling and holding one tab. <span className="field-constraints">max 100 items</span> |
</div>

## BlockTableContent

A top-level table.

<div className="reference-table">
  | Field                                                              | Type                           | Description                                                                                                                                    |
  | ------------------------------------------------------------------ | ------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------- |
  | `tableWidth` <span className="required" title="required">\*</span> | `integer`                      | The number of columns. Fixed at creation — an update cannot change it. <span className="field-constraints">≥ 1</span>                          |
  | `hasColumnHeader`                                                  | `boolean`                      | Whether the first row is styled as a header.                                                                                                   |
  | `hasRowHeader`                                                     | `boolean`                      | Whether the first column is styled as a header.                                                                                                |
  | `children` <span className="required" title="required">\*</span>   | [NestedBlock](#nestedblock)\[] | The table's rows, each a `table_row` block whose `cells` count matches `table_width`. <span className="field-constraints">max 100 items</span> |
</div>

## BlockColumnListContent

A top-level row of side-by-side columns.

<div className="reference-table">
  | Field                                                            | Type                           | Description                                                                                                                    |
  | ---------------------------------------------------------------- | ------------------------------ | ------------------------------------------------------------------------------------------------------------------------------ |
  | `children` <span className="required" title="required">\*</span> | [NestedBlock](#nestedblock)\[] | The columns, each a `column` block. A column list needs at least two. <span className="field-constraints">max 100 items</span> |
</div>

## BlockColumnContent

One column of a top-level column list.

<div className="reference-table">
  | Field                                                            | Type                           | Description                                                                                                                                                                                    |
  | ---------------------------------------------------------------- | ------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
  | `widthRatio`                                                     | `number`                       | This column's share of the row's width, between 0 and 1. The ratios across one column list should sum to 1; absent, the columns are equal. <span className="field-constraints">≥ 0; ≤ 1</span> |
  | `children` <span className="required" title="required">\*</span> | [NestedBlock](#nestedblock)\[] | The blocks stacked in this column. <span className="field-constraints">max 100 items</span>                                                                                                    |
</div>

## Template

The template a new or updated page is built from.

<div className="reference-table">
  | Field                                                        | Type                                   | Description                                                                                                                                   |
  | ------------------------------------------------------------ | -------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------- |
  | `type` <span className="required" title="required">\*</span> | `"none" \| "default" \| "template_id"` | Which template to apply: `none` for an empty page, `default` for the parent database's default template, or `template_id` for a specific one. |
  | `templateId`                                                 | `string`                               | The ID of the template page to apply, when `type` is `template_id`.                                                                           |
  | `timezone`                                                   | `string`                               | An IANA time zone name, for example `America/New_York`, used to resolve date placeholders in the template.                                    |
</div>

## Position

Where new blocks are placed among a parent's existing children.

<div className="reference-table">
  | Field        | Type                                          | Description                                                       |
  | ------------ | --------------------------------------------- | ----------------------------------------------------------------- |
  | `type`       | `"after_block" \| "page_start" \| "page_end"` | Where to insert the new content.                                  |
  | `afterBlock` | [AfterBlockRef](#afterblockref)               | The existing block to insert after, when `type` is `after_block`. |
</div>

## AfterBlockRef

The block that new content is inserted after.

<div className="reference-table">
  | Field                                                      | Type     | Description                                   |
  | ---------------------------------------------------------- | -------- | --------------------------------------------- |
  | `id` <span className="required" title="required">\*</span> | `string` | The ID of the existing block to insert after. |
</div>

## PageUpdateBody

The body of an update-page request.

<div className="reference-table">
  | Field          | Type                                           | Description                                                                                                                                                                                                                                                                                                           |
  | -------------- | ---------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
  | `properties`   | map of [PagePropertyValue](#pagepropertyvalue) | The values of the page's properties, keyed by property name or ID. A page whose parent is a data source must use that data source's schema; a page whose parent is another page has only `title`. Set a value to null to clear it. Leave the computed types out of the map entirely rather than sending them as null. |
  | `icon`         | [Icon](#icon)                                  | The page's icon. Null removes it.                                                                                                                                                                                                                                                                                     |
  | `cover`        | [Cover](#cover)                                | The page's cover image. Null removes it.                                                                                                                                                                                                                                                                              |
  | `inTrash`      | `boolean`                                      | Whether the page is in the trash. False restores it.                                                                                                                                                                                                                                                                  |
  | `isArchived`   | `boolean`                                      | Whether the page is archived. `in_trash` is the field to reach for; this is the older spelling and the API still accepts it.                                                                                                                                                                                          |
  | `isLocked`     | `boolean`                                      | Whether the page is locked against editing in the Notion app. It does not block writes through the API.                                                                                                                                                                                                               |
  | `template`     | [Template](#template)                          | A template to apply to the page.                                                                                                                                                                                                                                                                                      |
  | `eraseContent` | `boolean`                                      | Whether to delete every block on the page.                                                                                                                                                                                                                                                                            |
</div>

## PageMoveBody

The body of a move-page request.

<div className="reference-table">
  | Field                                                          | Type              | Description                |
  | -------------------------------------------------------------- | ----------------- | -------------------------- |
  | `parent` <span className="required" title="required">\*</span> | [Parent](#parent) | Where to move the page to. |
</div>

## PageMarkdownUpdateBody

The body of an update-page-markdown request.

<div className="reference-table">
  | Field            | Type                                                                                   | Description                                                                                                             |
  | ---------------- | -------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------- |
  | `type`           | `"update_content" \| "replace_content" \| "insert_content" \| "replace_content_range"` | Which operation to perform.                                                                                             |
  | `updateContent`  | [UpdateContentOp](#updatecontentop)                                                    | Edit parts of the page by search and replace.                                                                           |
  | `replaceContent` | [ReplaceContentOp](#replacecontentop)                                                  | Replace the whole of the page's content.                                                                                |
  | `allowAsync`     | `boolean`                                                                              | Whether a large edit may run in the background, answering 202 with an async task to poll rather than the finished page. |
</div>

## UpdateContentOp

Edit parts of a page, leaving the rest alone.

<div className="reference-table">
  | Field                                                                  | Type                               | Description                                                                                                                                          |
  | ---------------------------------------------------------------------- | ---------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------- |
  | `contentUpdates` <span className="required" title="required">\*</span> | [ContentUpdate](#contentupdate)\[] | The search-and-replace operations to apply, in order.                                                                                                |
  | `allowDeletingContent`                                                 | `boolean`                          | Whether an edit may delete child pages or databases. Refused when absent, so a replacement that would remove one fails rather than doing it quietly. |
</div>

## ContentUpdate

One search-and-replace over a page's Markdown.

<div className="reference-table">
  | Field                                                          | Type     | Description                                                                                                                 |
  | -------------------------------------------------------------- | -------- | --------------------------------------------------------------------------------------------------------------------------- |
  | `oldStr` <span className="required" title="required">\*</span> | `string` | The existing content to find. It must match a unique stretch of the page, or the operation cannot tell which one you meant. |
  | `newStr` <span className="required" title="required">\*</span> | `string` | What to put in its place.                                                                                                   |
</div>

## ReplaceContentOp

Replace a page's entire content.

<div className="reference-table">
  | Field                                                          | Type      | Description                                                                       |
  | -------------------------------------------------------------- | --------- | --------------------------------------------------------------------------------- |
  | `newStr` <span className="required" title="required">\*</span> | `string`  | The Markdown that becomes the whole of the page's content.                        |
  | `allowDeletingContent`                                         | `boolean` | Whether the replacement may delete child pages or databases. Refused when absent. |
</div>

## NotionColor

<div className="enum-table">
  | Value                |
  | -------------------- |
  | `default`            |
  | `default_background` |
  | `blue`               |
  | `blue_background`    |
  | `brown`              |
  | `brown_background`   |
  | `gray`               |
  | `gray_background`    |
  | `green`              |
  | `green_background`   |
  | `orange`             |
  | `orange_background`  |
  | `pink`               |
  | `pink_background`    |
  | `purple`             |
  | `purple_background`  |
  | `red`                |
  | `red_background`     |
  | `yellow`             |
  | `yellow_background`  |
</div>

## CodeLanguage

<div className="enum-table">
  | Value            |
  | ---------------- |
  | `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#`  |
</div>