Block
Defined in: src/models/block.model.ts:9
Block model wrapping a validated Notion block object with helper methods.
Extends
Section titled “Extends”Constructors
Section titled “Constructors”Constructor
Section titled “Constructor”new Block(
data):Block
Defined in: src/models/block.model.ts:10
Parameters
Section titled “Parameters”unknown
Returns
Section titled “Returns”Block
Overrides
Section titled “Overrides”BaseModel<NotionBlock>.constructor
Accessors
Section titled “Accessors”createdTime
Section titled “createdTime”Get Signature
Section titled “Get Signature”get createdTime():
Date
Defined in: src/models/block.model.ts:26
Returns
Section titled “Returns”Date
hasChildren
Section titled “hasChildren”Get Signature
Section titled “Get Signature”get hasChildren():
boolean
Defined in: src/models/block.model.ts:38
Returns
Section titled “Returns”boolean
Get Signature
Section titled “Get Signature”get id():
string
Defined in: src/models/block.model.ts:18
Returns the unique identifier.
Returns
Section titled “Returns”string
Overrides
Section titled “Overrides”inTrash
Section titled “inTrash”Get Signature
Section titled “Get Signature”get inTrash():
boolean
Defined in: src/models/block.model.ts:34
Returns
Section titled “Returns”boolean
lastEditedTime
Section titled “lastEditedTime”Get Signature
Section titled “Get Signature”get lastEditedTime():
Date
Defined in: src/models/block.model.ts:30
Returns
Section titled “Returns”Date
object
Section titled “object”Get Signature
Section titled “Get Signature”get object():
string
Defined in: src/models/block.model.ts:14
Returns the object type, for example “page”, “block”, or “user”.
Returns
Section titled “Returns”string
Overrides
Section titled “Overrides”Get Signature
Section titled “Get Signature”get type():
"file"|"code"|"link_preview"|"equation"|"audio"|"bookmark"|"breadcrumb"|"bulleted_list_item"|"callout"|"child_database"|"child_page"|"column"|"column_list"|"divider"|"embed"|"heading_1"|"heading_2"|"heading_3"|"heading_4"|"image"|"numbered_list_item"|"paragraph"|"pdf"|"quote"|"synced_block"|"tab"|"table"|"table_of_contents"|"table_row"|"template"|"to_do"|"toggle"|"meeting_notes"|"unsupported"|"video"
Defined in: src/models/block.model.ts:22
Returns
Section titled “Returns”"file" | "code" | "link_preview" | "equation" | "audio" | "bookmark" | "breadcrumb" | "bulleted_list_item" | "callout" | "child_database" | "child_page" | "column" | "column_list" | "divider" | "embed" | "heading_1" | "heading_2" | "heading_3" | "heading_4" | "image" | "numbered_list_item" | "paragraph" | "pdf" | "quote" | "synced_block" | "tab" | "table" | "table_of_contents" | "table_row" | "template" | "to_do" | "toggle" | "meeting_notes" | "unsupported" | "video"
Methods
Section titled “Methods”canHaveChildren()
Section titled “canHaveChildren()”canHaveChildren():
boolean
Defined in: src/models/block.model.ts:71
Check if this block can contain children.
Returns
Section titled “Returns”boolean
getPlainText()
Section titled “getPlainText()”getPlainText():
string|null
Defined in: src/models/block.model.ts:95
Get the plain text content from text-based blocks.
Returns
Section titled “Returns”string | null
isHeading()
Section titled “isHeading()”isHeading():
boolean
Defined in: src/models/block.model.ts:64
Check if this is a heading block.
Returns
Section titled “Returns”boolean
isTextBlock()
Section titled “isTextBlock()”isTextBlock():
boolean
Defined in: src/models/block.model.ts:45
Check if this is a text-based block type.
Returns
Section titled “Returns”boolean
toJSON()
Section titled “toJSON()”toJSON():
object
Defined in: src/models/base.model.ts:20
Returns the raw validated data as a plain object.
Returns
Section titled “Returns”object
audio?
Section titled “audio?”
optionalaudio?: {file: {expiry_time:string;url:string; };type:"file"; } | {file_upload: {id:string; };type:"file_upload"; } | {external: {url:string; };type:"external"; }
bookmark?
Section titled “bookmark?”
optionalbookmark?:object
bookmark.caption
Section titled “bookmark.caption”caption: ({
annotations: {bold:boolean;code:boolean;color:"default"|"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";italic:boolean;strikethrough:boolean;underline:boolean; };href:string|null;plain_text:string;text: {content:string;link: {url:string; } |null; };type:"text"; } | {annotations: {bold:boolean;code:boolean;color:"default"|"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";italic:boolean;strikethrough:boolean;underline:boolean; };href:string|null;mention: {database: {id:string; };type:"database"; } | {date: {end:string|null;start:string;time_zone?:string|null; };type:"date"; } | {link_preview: {url:string; };type:"link_preview"; } | {page: {id:string; };type:"page"; } | {template_mention: {template_mention_date: … | …;type:"template_mention_date"; } | {template_mention_user:"me";type:"template_mention_user"; };type:"template_mention"; } | {type:"user";user: {avatar_url?: … | … | …;id:string;name?: … | …;object:"user";person: {email_verified?: …; };type:"person"; } | {avatar_url?: … | … | …;bot: {owner: …;workspace_id?: …;workspace_limits?: …;workspace_name?: …; };id:string;name?: … | …;object:"user";type:"bot"; } | {id:string;object:"user"; }; };plain_text:string;type:"mention"; } | {annotations: {bold:boolean;code:boolean;color:"default"|"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";italic:boolean;strikethrough:boolean;underline:boolean; };equation: {expression:string; };href:string|null;plain_text:string;type:"equation"; })[] =richTextSchema
bookmark.url
Section titled “bookmark.url”url:
string
breadcrumb?
Section titled “breadcrumb?”
optionalbreadcrumb?:Record<string,never>
bulleted_list_item?
Section titled “bulleted_list_item?”
optionalbulleted_list_item?:object
bulleted_list_item.children?
Section titled “bulleted_list_item.children?”
optionalchildren?:unknown[]
bulleted_list_item.color
Section titled “bulleted_list_item.color”color:
"default"|"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"
bulleted_list_item.rich_text
Section titled “bulleted_list_item.rich_text”rich_text: ({
annotations: {bold:boolean;code:boolean;color:"default"|"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";italic:boolean;strikethrough:boolean;underline:boolean; };href:string|null;plain_text:string;text: {content:string;link: {url:string; } |null; };type:"text"; } | {annotations: {bold:boolean;code:boolean;color:"default"|"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";italic:boolean;strikethrough:boolean;underline:boolean; };href:string|null;mention: {database: {id:string; };type:"database"; } | {date: {end:string|null;start:string;time_zone?:string|null; };type:"date"; } | {link_preview: {url:string; };type:"link_preview"; } | {page: {id:string; };type:"page"; } | {template_mention: {template_mention_date: … | …;type:"template_mention_date"; } | {template_mention_user:"me";type:"template_mention_user"; };type:"template_mention"; } | {type:"user";user: {avatar_url?: … | … | …;id:string;name?: … | …;object:"user";person: {email_verified?: …; };type:"person"; } | {avatar_url?: … | … | …;bot: {owner: …;workspace_id?: …;workspace_limits?: …;workspace_name?: …; };id:string;name?: … | …;object:"user";type:"bot"; } | {id:string;object:"user"; }; };plain_text:string;type:"mention"; } | {annotations: {bold:boolean;code:boolean;color:"default"|"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";italic:boolean;strikethrough:boolean;underline:boolean; };equation: {expression:string; };href:string|null;plain_text:string;type:"equation"; })[] =richTextSchema
callout?
Section titled “callout?”
optionalcallout?:object
callout.children?
Section titled “callout.children?”
optionalchildren?:unknown[]
callout.color
Section titled “callout.color”color:
"default"|"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"
callout.icon
Section titled “callout.icon”icon: {
file: {expiry_time:string;url:string; };type:"file"; } | {file_upload: {id:string; };type:"file_upload"; } | {external: {url:string; };type:"external"; } | {emoji:string;type:"emoji"; } | {icon: {color?:"blue"|"brown"|"gray"|"green"|"orange"|"pink"|"purple"|"red"|"yellow"|"lightgray";name:string; };type:"icon"; } | {custom_emoji: {id:string;name?:string;url?:string; };type:"custom_emoji"; } =iconSchema
callout.rich_text
Section titled “callout.rich_text”rich_text: ({
annotations: {bold:boolean;code:boolean;color:"default"|"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";italic:boolean;strikethrough:boolean;underline:boolean; };href:string|null;plain_text:string;text: {content:string;link: {url:string; } |null; };type:"text"; } | {annotations: {bold:boolean;code:boolean;color:"default"|"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";italic:boolean;strikethrough:boolean;underline:boolean; };href:string|null;mention: {database: {id:string; };type:"database"; } | {date: {end:string|null;start:string;time_zone?:string|null; };type:"date"; } | {link_preview: {url:string; };type:"link_preview"; } | {page: {id:string; };type:"page"; } | {template_mention: {template_mention_date: … | …;type:"template_mention_date"; } | {template_mention_user:"me";type:"template_mention_user"; };type:"template_mention"; } | {type:"user";user: {avatar_url?: … | … | …;id:string;name?: … | …;object:"user";person: {email_verified?: …; };type:"person"; } | {avatar_url?: … | … | …;bot: {owner: …;workspace_id?: …;workspace_limits?: …;workspace_name?: …; };id:string;name?: … | …;object:"user";type:"bot"; } | {id:string;object:"user"; }; };plain_text:string;type:"mention"; } | {annotations: {bold:boolean;code:boolean;color:"default"|"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";italic:boolean;strikethrough:boolean;underline:boolean; };equation: {expression:string; };href:string|null;plain_text:string;type:"equation"; })[] =richTextSchema
child_database?
Section titled “child_database?”
optionalchild_database?:object
child_database.title
Section titled “child_database.title”title:
string
child_page?
Section titled “child_page?”
optionalchild_page?:object
child_page.title
Section titled “child_page.title”title:
string
optionalcode?:object
code.caption
Section titled “code.caption”caption: ({
annotations: {bold:boolean;code:boolean;color:"default"|"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";italic:boolean;strikethrough:boolean;underline:boolean; };href:string|null;plain_text:string;text: {content:string;link: {url:string; } |null; };type:"text"; } | {annotations: {bold:boolean;code:boolean;color:"default"|"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";italic:boolean;strikethrough:boolean;underline:boolean; };href:string|null;mention: {database: {id:string; };type:"database"; } | {date: {end:string|null;start:string;time_zone?:string|null; };type:"date"; } | {link_preview: {url:string; };type:"link_preview"; } | {page: {id:string; };type:"page"; } | {template_mention: {template_mention_date: … | …;type:"template_mention_date"; } | {template_mention_user:"me";type:"template_mention_user"; };type:"template_mention"; } | {type:"user";user: {avatar_url?: … | … | …;id:string;name?: … | …;object:"user";person: {email_verified?: …; };type:"person"; } | {avatar_url?: … | … | …;bot: {owner: …;workspace_id?: …;workspace_limits?: …;workspace_name?: …; };id:string;name?: … | …;object:"user";type:"bot"; } | {id:string;object:"user"; }; };plain_text:string;type:"mention"; } | {annotations: {bold:boolean;code:boolean;color:"default"|"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";italic:boolean;strikethrough:boolean;underline:boolean; };equation: {expression:string; };href:string|null;plain_text:string;type:"equation"; })[] =richTextSchema
code.language
Section titled “code.language”language:
"abap"|"arduino"|"bash"|"basic"|"c"|"clojure"|"coffeescript"|"c++"|"c#"|"css"|"dart"|"diff"|"docker"|"elixir"|"elm"|"erlang"|"flow"|"fortran"|"f#"|"gherkin"|"glsl"|"go"|"graphql"|"groovy"|"haskell"|"html"|"java"|"javascript"|"json"|"julia"|"kotlin"|"latex"|"less"|"lisp"|"livescript"|"lua"|"makefile"|"markdown"|"markup"|"matlab"|"mermaid"|"nix"|"objective-c"|"ocaml"|"pascal"|"perl"|"php"|"plain text"|"powershell"|"prolog"|"protobuf"|"python"|"r"|"reason"|"ruby"|"rust"|"sass"|"scala"|"scheme"|"scss"|"shell"|"sql"|"swift"|"typescript"|"vb.net"|"verilog"|"vhdl"|"visual basic"|"webassembly"|"xml"|"yaml"|"java/c/c++/c#"
code.rich_text
Section titled “code.rich_text”rich_text: ({
annotations: {bold:boolean;code:boolean;color:"default"|"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";italic:boolean;strikethrough:boolean;underline:boolean; };href:string|null;plain_text:string;text: {content:string;link: {url:string; } |null; };type:"text"; } | {annotations: {bold:boolean;code:boolean;color:"default"|"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";italic:boolean;strikethrough:boolean;underline:boolean; };href:string|null;mention: {database: {id:string; };type:"database"; } | {date: {end:string|null;start:string;time_zone?:string|null; };type:"date"; } | {link_preview: {url:string; };type:"link_preview"; } | {page: {id:string; };type:"page"; } | {template_mention: {template_mention_date: … | …;type:"template_mention_date"; } | {template_mention_user:"me";type:"template_mention_user"; };type:"template_mention"; } | {type:"user";user: {avatar_url?: … | … | …;id:string;name?: … | …;object:"user";person: {email_verified?: …; };type:"person"; } | {avatar_url?: … | … | …;bot: {owner: …;workspace_id?: …;workspace_limits?: …;workspace_name?: …; };id:string;name?: … | …;object:"user";type:"bot"; } | {id:string;object:"user"; }; };plain_text:string;type:"mention"; } | {annotations: {bold:boolean;code:boolean;color:"default"|"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";italic:boolean;strikethrough:boolean;underline:boolean; };equation: {expression:string; };href:string|null;plain_text:string;type:"equation"; })[] =richTextSchema
column?
Section titled “column?”
optionalcolumn?:object
column.children?
Section titled “column.children?”
optionalchildren?:unknown[]
column.width_ratio?
Section titled “column.width_ratio?”
optionalwidth_ratio?:number
column_list?
Section titled “column_list?”
optionalcolumn_list?:object
column_list.children?
Section titled “column_list.children?”
optionalchildren?:unknown[]
created_by
Section titled “created_by”created_by: {
avatar_url?:string|null;id:string;name?:string;object:"user";person: {string;email_verified?:boolean; };type:"person"; } | {avatar_url?:string|null;bot: {owner: {type:"workspace";workspace:true; } | {type:"user"; };workspace_id?:string;workspace_limits?: {max_file_upload_size_in_bytes:number; };workspace_name?:string|null; };id:string;name?:string;object:"user";type:"bot"; } | {id:string;object:"user"; } =userSchema
created_time
Section titled “created_time”created_time:
string=notionDateStringSchema
divider?
Section titled “divider?”
optionaldivider?:Record<string,never>
embed?
Section titled “embed?”
optionalembed?:object
embed.url
Section titled “embed.url”url:
string
equation?
Section titled “equation?”
optionalequation?:object
equation.expression
Section titled “equation.expression”expression:
string
optionalfile?:object
file.caption
Section titled “file.caption”caption: ({
annotations: {bold:boolean;code:boolean;color:"default"|"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";italic:boolean;strikethrough:boolean;underline:boolean; };href:string|null;plain_text:string;text: {content:string;link: {url:string; } |null; };type:"text"; } | {annotations: {bold:boolean;code:boolean;color:"default"|"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";italic:boolean;strikethrough:boolean;underline:boolean; };href:string|null;mention: {database: {id:string; };type:"database"; } | {date: {end:string|null;start:string;time_zone?:string|null; };type:"date"; } | {link_preview: {url:string; };type:"link_preview"; } | {page: {id:string; };type:"page"; } | {template_mention: {template_mention_date: … | …;type:"template_mention_date"; } | {template_mention_user:"me";type:"template_mention_user"; };type:"template_mention"; } | {type:"user";user: {avatar_url?: … | … | …;id:string;name?: … | …;object:"user";person: {email_verified?: …; };type:"person"; } | {avatar_url?: … | … | …;bot: {owner: …;workspace_id?: …;workspace_limits?: …;workspace_name?: …; };id:string;name?: … | …;object:"user";type:"bot"; } | {id:string;object:"user"; }; };plain_text:string;type:"mention"; } | {annotations: {bold:boolean;code:boolean;color:"default"|"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";italic:boolean;strikethrough:boolean;underline:boolean; };equation: {expression:string; };href:string|null;plain_text:string;type:"equation"; })[] =richTextSchema
file.external?
Section titled “file.external?”
optionalexternal?: {file: {expiry_time:string;url:string; };type:"file"; } | {file_upload: {id:string; };type:"file_upload"; } | {external: {url:string; };type:"external"; }
file.file?
Section titled “file.file?”
optionalfile?: {file: {expiry_time:string;url:string; };type:"file"; } | {file_upload: {id:string; };type:"file_upload"; } | {external: {url:string; };type:"external"; }
file.file_upload?
Section titled “file.file_upload?”
optionalfile_upload?: {file: {expiry_time:string;url:string; };type:"file"; } | {file_upload: {id:string; };type:"file_upload"; } | {external: {url:string; };type:"external"; }
file.name?
Section titled “file.name?”
optionalname?:string
file.type
Section titled “file.type”type:
"file"|"file_upload"|"external"
has_children
Section titled “has_children”has_children:
boolean
heading_1?
Section titled “heading_1?”
optionalheading_1?:object
heading_1.children?
Section titled “heading_1.children?”
optionalchildren?:unknown[]
heading_1.color
Section titled “heading_1.color”color:
"default"|"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"
heading_1.is_toggleable
Section titled “heading_1.is_toggleable”is_toggleable:
boolean
heading_1.rich_text
Section titled “heading_1.rich_text”rich_text: ({
annotations: {bold:boolean;code:boolean;color:"default"|"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";italic:boolean;strikethrough:boolean;underline:boolean; };href:string|null;plain_text:string;text: {content:string;link: {url:string; } |null; };type:"text"; } | {annotations: {bold:boolean;code:boolean;color:"default"|"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";italic:boolean;strikethrough:boolean;underline:boolean; };href:string|null;mention: {database: {id:string; };type:"database"; } | {date: {end:string|null;start:string;time_zone?:string|null; };type:"date"; } | {link_preview: {url:string; };type:"link_preview"; } | {page: {id:string; };type:"page"; } | {template_mention: {template_mention_date: … | …;type:"template_mention_date"; } | {template_mention_user:"me";type:"template_mention_user"; };type:"template_mention"; } | {type:"user";user: {avatar_url?: … | … | …;id:string;name?: … | …;object:"user";person: {email_verified?: …; };type:"person"; } | {avatar_url?: … | … | …;bot: {owner: …;workspace_id?: …;workspace_limits?: …;workspace_name?: …; };id:string;name?: … | …;object:"user";type:"bot"; } | {id:string;object:"user"; }; };plain_text:string;type:"mention"; } | {annotations: {bold:boolean;code:boolean;color:"default"|"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";italic:boolean;strikethrough:boolean;underline:boolean; };equation: {expression:string; };href:string|null;plain_text:string;type:"equation"; })[] =richTextSchema
heading_2?
Section titled “heading_2?”
optionalheading_2?:object
heading_2.children?
Section titled “heading_2.children?”
optionalchildren?:unknown[]
heading_2.color
Section titled “heading_2.color”color:
"default"|"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"
heading_2.is_toggleable
Section titled “heading_2.is_toggleable”is_toggleable:
boolean
heading_2.rich_text
Section titled “heading_2.rich_text”rich_text: ({
annotations: {bold:boolean;code:boolean;color:"default"|"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";italic:boolean;strikethrough:boolean;underline:boolean; };href:string|null;plain_text:string;text: {content:string;link: {url:string; } |null; };type:"text"; } | {annotations: {bold:boolean;code:boolean;color:"default"|"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";italic:boolean;strikethrough:boolean;underline:boolean; };href:string|null;mention: {database: {id:string; };type:"database"; } | {date: {end:string|null;start:string;time_zone?:string|null; };type:"date"; } | {link_preview: {url:string; };type:"link_preview"; } | {page: {id:string; };type:"page"; } | {template_mention: {template_mention_date: … | …;type:"template_mention_date"; } | {template_mention_user:"me";type:"template_mention_user"; };type:"template_mention"; } | {type:"user";user: {avatar_url?: … | … | …;id:string;name?: … | …;object:"user";person: {email_verified?: …; };type:"person"; } | {avatar_url?: … | … | …;bot: {owner: …;workspace_id?: …;workspace_limits?: …;workspace_name?: …; };id:string;name?: … | …;object:"user";type:"bot"; } | {id:string;object:"user"; }; };plain_text:string;type:"mention"; } | {annotations: {bold:boolean;code:boolean;color:"default"|"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";italic:boolean;strikethrough:boolean;underline:boolean; };equation: {expression:string; };href:string|null;plain_text:string;type:"equation"; })[] =richTextSchema
heading_3?
Section titled “heading_3?”
optionalheading_3?:object
heading_3.children?
Section titled “heading_3.children?”
optionalchildren?:unknown[]
heading_3.color
Section titled “heading_3.color”color:
"default"|"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"
heading_3.is_toggleable
Section titled “heading_3.is_toggleable”is_toggleable:
boolean
heading_3.rich_text
Section titled “heading_3.rich_text”rich_text: ({
annotations: {bold:boolean;code:boolean;color:"default"|"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";italic:boolean;strikethrough:boolean;underline:boolean; };href:string|null;plain_text:string;text: {content:string;link: {url:string; } |null; };type:"text"; } | {annotations: {bold:boolean;code:boolean;color:"default"|"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";italic:boolean;strikethrough:boolean;underline:boolean; };href:string|null;mention: {database: {id:string; };type:"database"; } | {date: {end:string|null;start:string;time_zone?:string|null; };type:"date"; } | {link_preview: {url:string; };type:"link_preview"; } | {page: {id:string; };type:"page"; } | {template_mention: {template_mention_date: … | …;type:"template_mention_date"; } | {template_mention_user:"me";type:"template_mention_user"; };type:"template_mention"; } | {type:"user";user: {avatar_url?: … | … | …;id:string;name?: … | …;object:"user";person: {email_verified?: …; };type:"person"; } | {avatar_url?: … | … | …;bot: {owner: …;workspace_id?: …;workspace_limits?: …;workspace_name?: …; };id:string;name?: … | …;object:"user";type:"bot"; } | {id:string;object:"user"; }; };plain_text:string;type:"mention"; } | {annotations: {bold:boolean;code:boolean;color:"default"|"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";italic:boolean;strikethrough:boolean;underline:boolean; };equation: {expression:string; };href:string|null;plain_text:string;type:"equation"; })[] =richTextSchema
heading_4?
Section titled “heading_4?”
optionalheading_4?:object
heading_4.children?
Section titled “heading_4.children?”
optionalchildren?:unknown[]
heading_4.color
Section titled “heading_4.color”color:
"default"|"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"
heading_4.is_toggleable
Section titled “heading_4.is_toggleable”is_toggleable:
boolean
heading_4.rich_text
Section titled “heading_4.rich_text”rich_text: ({
annotations: {bold:boolean;code:boolean;color:"default"|"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";italic:boolean;strikethrough:boolean;underline:boolean; };href:string|null;plain_text:string;text: {content:string;link: {url:string; } |null; };type:"text"; } | {annotations: {bold:boolean;code:boolean;color:"default"|"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";italic:boolean;strikethrough:boolean;underline:boolean; };href:string|null;mention: {database: {id:string; };type:"database"; } | {date: {end:string|null;start:string;time_zone?:string|null; };type:"date"; } | {link_preview: {url:string; };type:"link_preview"; } | {page: {id:string; };type:"page"; } | {template_mention: {template_mention_date: … | …;type:"template_mention_date"; } | {template_mention_user:"me";type:"template_mention_user"; };type:"template_mention"; } | {type:"user";user: {avatar_url?: … | … | …;id:string;name?: … | …;object:"user";person: {email_verified?: …; };type:"person"; } | {avatar_url?: … | … | …;bot: {owner: …;workspace_id?: …;workspace_limits?: …;workspace_name?: …; };id:string;name?: … | …;object:"user";type:"bot"; } | {id:string;object:"user"; }; };plain_text:string;type:"mention"; } | {annotations: {bold:boolean;code:boolean;color:"default"|"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";italic:boolean;strikethrough:boolean;underline:boolean; };equation: {expression:string; };href:string|null;plain_text:string;type:"equation"; })[] =richTextSchema
id:
string
image?
Section titled “image?”
optionalimage?: {file: {expiry_time:string;url:string; };type:"file"; } | {file_upload: {id:string; };type:"file_upload"; } | {external: {url:string; };type:"external"; }
in_trash
Section titled “in_trash”in_trash:
boolean
last_edited_by
Section titled “last_edited_by”last_edited_by: {
avatar_url?:string|null;id:string;name?:string;object:"user";person: {string;email_verified?:boolean; };type:"person"; } | {avatar_url?:string|null;bot: {owner: {type:"workspace";workspace:true; } | {type:"user"; };workspace_id?:string;workspace_limits?: {max_file_upload_size_in_bytes:number; };workspace_name?:string|null; };id:string;name?:string;object:"user";type:"bot"; } | {id:string;object:"user"; } =userSchema
last_edited_time
Section titled “last_edited_time”last_edited_time:
string=notionDateStringSchema
link_preview?
Section titled “link_preview?”
optionallink_preview?:object
link_preview.url
Section titled “link_preview.url”url:
string
meeting_notes?
Section titled “meeting_notes?”
optionalmeeting_notes?:object
meeting_notes.calendar_event?
Section titled “meeting_notes.calendar_event?”
optionalcalendar_event?:unknown
meeting_notes.children
Section titled “meeting_notes.children”children:
object
meeting_notes.children.notes_block_id?
Section titled “meeting_notes.children.notes_block_id?”
optionalnotes_block_id?:string|null
meeting_notes.children.summary_block_id?
Section titled “meeting_notes.children.summary_block_id?”
optionalsummary_block_id?:string|null
meeting_notes.children.transcript_block_id?
Section titled “meeting_notes.children.transcript_block_id?”
optionaltranscript_block_id?:string|null
meeting_notes.recording?
Section titled “meeting_notes.recording?”
optionalrecording?:unknown
meeting_notes.status
Section titled “meeting_notes.status”status:
string
meeting_notes.title
Section titled “meeting_notes.title”title: ({
annotations: {bold:boolean;code:boolean;color:"default"|"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";italic:boolean;strikethrough:boolean;underline:boolean; };href:string|null;plain_text:string;text: {content:string;link: {url:string; } |null; };type:"text"; } | {annotations: {bold:boolean;code:boolean;color:"default"|"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";italic:boolean;strikethrough:boolean;underline:boolean; };href:string|null;mention: {database: {id:string; };type:"database"; } | {date: {end:string|null;start:string;time_zone?:string|null; };type:"date"; } | {link_preview: {url:string; };type:"link_preview"; } | {page: {id:string; };type:"page"; } | {template_mention: {template_mention_date: … | …;type:"template_mention_date"; } | {template_mention_user:"me";type:"template_mention_user"; };type:"template_mention"; } | {type:"user";user: {avatar_url?: … | … | …;id:string;name?: … | …;object:"user";person: {email_verified?: …; };type:"person"; } | {avatar_url?: … | … | …;bot: {owner: …;workspace_id?: …;workspace_limits?: …;workspace_name?: …; };id:string;name?: … | …;object:"user";type:"bot"; } | {id:string;object:"user"; }; };plain_text:string;type:"mention"; } | {annotations: {bold:boolean;code:boolean;color:"default"|"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";italic:boolean;strikethrough:boolean;underline:boolean; };equation: {expression:string; };href:string|null;plain_text:string;type:"equation"; })[] =richTextSchema
numbered_list_item?
Section titled “numbered_list_item?”
optionalnumbered_list_item?:object
numbered_list_item.children?
Section titled “numbered_list_item.children?”
optionalchildren?:unknown[]
numbered_list_item.color
Section titled “numbered_list_item.color”color:
"default"|"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"
numbered_list_item.list_format?
Section titled “numbered_list_item.list_format?”
optionallist_format?:"numbers"|"letters"|"roman"
numbered_list_item.list_start_index?
Section titled “numbered_list_item.list_start_index?”
optionallist_start_index?:number
numbered_list_item.rich_text
Section titled “numbered_list_item.rich_text”rich_text: ({
annotations: {bold:boolean;code:boolean;color:"default"|"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";italic:boolean;strikethrough:boolean;underline:boolean; };href:string|null;plain_text:string;text: {content:string;link: {url:string; } |null; };type:"text"; } | {annotations: {bold:boolean;code:boolean;color:"default"|"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";italic:boolean;strikethrough:boolean;underline:boolean; };href:string|null;mention: {database: {id:string; };type:"database"; } | {date: {end:string|null;start:string;time_zone?:string|null; };type:"date"; } | {link_preview: {url:string; };type:"link_preview"; } | {page: {id:string; };type:"page"; } | {template_mention: {template_mention_date: … | …;type:"template_mention_date"; } | {template_mention_user:"me";type:"template_mention_user"; };type:"template_mention"; } | {type:"user";user: {avatar_url?: … | … | …;id:string;name?: … | …;object:"user";person: {email_verified?: …; };type:"person"; } | {avatar_url?: … | … | …;bot: {owner: …;workspace_id?: …;workspace_limits?: …;workspace_name?: …; };id:string;name?: … | …;object:"user";type:"bot"; } | {id:string;object:"user"; }; };plain_text:string;type:"mention"; } | {annotations: {bold:boolean;code:boolean;color:"default"|"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";italic:boolean;strikethrough:boolean;underline:boolean; };equation: {expression:string; };href:string|null;plain_text:string;type:"equation"; })[] =richTextSchema
object
Section titled “object”object:
"block"
paragraph?
Section titled “paragraph?”
optionalparagraph?:object
paragraph.children?
Section titled “paragraph.children?”
optionalchildren?:unknown[]
paragraph.color
Section titled “paragraph.color”color:
"default"|"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"
paragraph.icon?
Section titled “paragraph.icon?”
optionalicon?: {file: {expiry_time:string;url:string; };type:"file"; } | {file_upload: {id:string; };type:"file_upload"; } | {external: {url:string; };type:"external"; } | {emoji:string;type:"emoji"; } | {icon: {color?:"blue"|"brown"|"gray"|"green"|"orange"|"pink"|"purple"|"red"|"yellow"|"lightgray";name:string; };type:"icon"; } | {custom_emoji: {id:string;name?:string;url?:string; };type:"custom_emoji"; }
paragraph.rich_text
Section titled “paragraph.rich_text”rich_text: ({
annotations: {bold:boolean;code:boolean;color:"default"|"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";italic:boolean;strikethrough:boolean;underline:boolean; };href:string|null;plain_text:string;text: {content:string;link: {url:string; } |null; };type:"text"; } | {annotations: {bold:boolean;code:boolean;color:"default"|"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";italic:boolean;strikethrough:boolean;underline:boolean; };href:string|null;mention: {database: {id:string; };type:"database"; } | {date: {end:string|null;start:string;time_zone?:string|null; };type:"date"; } | {link_preview: {url:string; };type:"link_preview"; } | {page: {id:string; };type:"page"; } | {template_mention: {template_mention_date: … | …;type:"template_mention_date"; } | {template_mention_user:"me";type:"template_mention_user"; };type:"template_mention"; } | {type:"user";user: {avatar_url?: … | … | …;id:string;name?: … | …;object:"user";person: {email_verified?: …; };type:"person"; } | {avatar_url?: … | … | …;bot: {owner: …;workspace_id?: …;workspace_limits?: …;workspace_name?: …; };id:string;name?: … | …;object:"user";type:"bot"; } | {id:string;object:"user"; }; };plain_text:string;type:"mention"; } | {annotations: {bold:boolean;code:boolean;color:"default"|"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";italic:boolean;strikethrough:boolean;underline:boolean; };equation: {expression:string; };href:string|null;plain_text:string;type:"equation"; })[] =richTextSchema
parent
Section titled “parent”parent: {
database_id:string;type:"database_id"; } | {data_source_id:string;database_id:string;type:"data_source_id"; } | {page_id:string;type:"page_id"; } | {type:"workspace";workspace:true; } | {block_id:string;type:"block_id"; } | {agent_id:string;type:"agent_id"; } =parentSchema
optionalpdf?:object
pdf.caption
Section titled “pdf.caption”caption: ({
annotations: {bold:boolean;code:boolean;color:"default"|"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";italic:boolean;strikethrough:boolean;underline:boolean; };href:string|null;plain_text:string;text: {content:string;link: {url:string; } |null; };type:"text"; } | {annotations: {bold:boolean;code:boolean;color:"default"|"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";italic:boolean;strikethrough:boolean;underline:boolean; };href:string|null;mention: {database: {id:string; };type:"database"; } | {date: {end:string|null;start:string;time_zone?:string|null; };type:"date"; } | {link_preview: {url:string; };type:"link_preview"; } | {page: {id:string; };type:"page"; } | {template_mention: {template_mention_date: … | …;type:"template_mention_date"; } | {template_mention_user:"me";type:"template_mention_user"; };type:"template_mention"; } | {type:"user";user: {avatar_url?: … | … | …;id:string;name?: … | …;object:"user";person: {email_verified?: …; };type:"person"; } | {avatar_url?: … | … | …;bot: {owner: …;workspace_id?: …;workspace_limits?: …;workspace_name?: …; };id:string;name?: … | …;object:"user";type:"bot"; } | {id:string;object:"user"; }; };plain_text:string;type:"mention"; } | {annotations: {bold:boolean;code:boolean;color:"default"|"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";italic:boolean;strikethrough:boolean;underline:boolean; };equation: {expression:string; };href:string|null;plain_text:string;type:"equation"; })[] =richTextSchema
pdf.external?
Section titled “pdf.external?”
optionalexternal?: {file: {expiry_time:string;url:string; };type:"file"; } | {file_upload: {id:string; };type:"file_upload"; } | {external: {url:string; };type:"external"; }
pdf.file?
Section titled “pdf.file?”
optionalfile?: {file: {expiry_time:string;url:string; };type:"file"; } | {file_upload: {id:string; };type:"file_upload"; } | {external: {url:string; };type:"external"; }
pdf.file_upload?
Section titled “pdf.file_upload?”
optionalfile_upload?: {file: {expiry_time:string;url:string; };type:"file"; } | {file_upload: {id:string; };type:"file_upload"; } | {external: {url:string; };type:"external"; }
pdf.name?
Section titled “pdf.name?”
optionalname?:string
pdf.type
Section titled “pdf.type”type:
"file"|"file_upload"|"external"
quote?
Section titled “quote?”
optionalquote?:object
quote.children?
Section titled “quote.children?”
optionalchildren?:unknown[]
quote.color
Section titled “quote.color”color:
"default"|"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"
quote.rich_text
Section titled “quote.rich_text”rich_text: ({
annotations: {bold:boolean;code:boolean;color:"default"|"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";italic:boolean;strikethrough:boolean;underline:boolean; };href:string|null;plain_text:string;text: {content:string;link: {url:string; } |null; };type:"text"; } | {annotations: {bold:boolean;code:boolean;color:"default"|"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";italic:boolean;strikethrough:boolean;underline:boolean; };href:string|null;mention: {database: {id:string; };type:"database"; } | {date: {end:string|null;start:string;time_zone?:string|null; };type:"date"; } | {link_preview: {url:string; };type:"link_preview"; } | {page: {id:string; };type:"page"; } | {template_mention: {template_mention_date: … | …;type:"template_mention_date"; } | {template_mention_user:"me";type:"template_mention_user"; };type:"template_mention"; } | {type:"user";user: {avatar_url?: … | … | …;id:string;name?: … | …;object:"user";person: {email_verified?: …; };type:"person"; } | {avatar_url?: … | … | …;bot: {owner: …;workspace_id?: …;workspace_limits?: …;workspace_name?: …; };id:string;name?: … | …;object:"user";type:"bot"; } | {id:string;object:"user"; }; };plain_text:string;type:"mention"; } | {annotations: {bold:boolean;code:boolean;color:"default"|"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";italic:boolean;strikethrough:boolean;underline:boolean; };equation: {expression:string; };href:string|null;plain_text:string;type:"equation"; })[] =richTextSchema
synced_block?
Section titled “synced_block?”
optionalsynced_block?:object
synced_block.children?
Section titled “synced_block.children?”
optionalchildren?:unknown[]
synced_block.synced_from
Section titled “synced_block.synced_from”synced_from: {
block_id:string;type:"block_id"; } |null
optionaltab?:object
tab.children?
Section titled “tab.children?”
optionalchildren?:unknown[]
table?
Section titled “table?”
optionaltable?:object
table.has_column_header
Section titled “table.has_column_header”has_column_header:
boolean
table.has_row_header
Section titled “table.has_row_header”has_row_header:
boolean
table.table_width
Section titled “table.table_width”table_width:
number
table_of_contents?
Section titled “table_of_contents?”
optionaltable_of_contents?:object
table_of_contents.color
Section titled “table_of_contents.color”color:
"default"|"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"
table_row?
Section titled “table_row?”
optionaltable_row?:object
table_row.cells
Section titled “table_row.cells”cells: ({
annotations: {bold:boolean;code:boolean;color:"default"|"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";italic:boolean;strikethrough:boolean;underline:boolean; };href:string|null;plain_text:string;text: {content:string;link: {url:string; } |null; };type:"text"; } | {annotations: {bold:boolean;code:boolean;color:"default"|"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";italic:boolean;strikethrough:boolean;underline:boolean; };href:string|null;mention: {database: {id:string; };type:"database"; } | {date: {end: … | …;start:string;time_zone?: … | … | …; };type:"date"; } | {link_preview: {url:string; };type:"link_preview"; } | {page: {id:string; };type:"page"; } | {template_mention: {template_mention_date: …;type: …; } | {template_mention_user: …;type: …; };type:"template_mention"; } | {type:"user";user: {avatar_url?: …;id: …;name?: …;object: …;person: …;type: …; } | {avatar_url?: …;bot: …;id: …;name?: …;object: …;type: …; } | {id: …;object: …; }; };plain_text:string;type:"mention"; } | {annotations: {bold:boolean;code:boolean;color:"default"|"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";italic:boolean;strikethrough:boolean;underline:boolean; };equation: {expression:string; };href:string|null;plain_text:string;type:"equation"; })[][]
template?
Section titled “template?”
optionaltemplate?:object
template.children?
Section titled “template.children?”
optionalchildren?:unknown[]
template.rich_text
Section titled “template.rich_text”rich_text: ({
annotations: {bold:boolean;code:boolean;color:"default"|"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";italic:boolean;strikethrough:boolean;underline:boolean; };href:string|null;plain_text:string;text: {content:string;link: {url:string; } |null; };type:"text"; } | {annotations: {bold:boolean;code:boolean;color:"default"|"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";italic:boolean;strikethrough:boolean;underline:boolean; };href:string|null;mention: {database: {id:string; };type:"database"; } | {date: {end:string|null;start:string;time_zone?:string|null; };type:"date"; } | {link_preview: {url:string; };type:"link_preview"; } | {page: {id:string; };type:"page"; } | {template_mention: {template_mention_date: … | …;type:"template_mention_date"; } | {template_mention_user:"me";type:"template_mention_user"; };type:"template_mention"; } | {type:"user";user: {avatar_url?: … | … | …;id:string;name?: … | …;object:"user";person: {email_verified?: …; };type:"person"; } | {avatar_url?: … | … | …;bot: {owner: …;workspace_id?: …;workspace_limits?: …;workspace_name?: …; };id:string;name?: … | …;object:"user";type:"bot"; } | {id:string;object:"user"; }; };plain_text:string;type:"mention"; } | {annotations: {bold:boolean;code:boolean;color:"default"|"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";italic:boolean;strikethrough:boolean;underline:boolean; };equation: {expression:string; };href:string|null;plain_text:string;type:"equation"; })[] =richTextSchema
to_do?
Section titled “to_do?”
optionalto_do?:object
to_do.checked?
Section titled “to_do.checked?”
optionalchecked?:boolean
to_do.children?
Section titled “to_do.children?”
optionalchildren?:unknown[]
to_do.color
Section titled “to_do.color”color:
"default"|"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"
to_do.rich_text
Section titled “to_do.rich_text”rich_text: ({
annotations: {bold:boolean;code:boolean;color:"default"|"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";italic:boolean;strikethrough:boolean;underline:boolean; };href:string|null;plain_text:string;text: {content:string;link: {url:string; } |null; };type:"text"; } | {annotations: {bold:boolean;code:boolean;color:"default"|"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";italic:boolean;strikethrough:boolean;underline:boolean; };href:string|null;mention: {database: {id:string; };type:"database"; } | {date: {end:string|null;start:string;time_zone?:string|null; };type:"date"; } | {link_preview: {url:string; };type:"link_preview"; } | {page: {id:string; };type:"page"; } | {template_mention: {template_mention_date: … | …;type:"template_mention_date"; } | {template_mention_user:"me";type:"template_mention_user"; };type:"template_mention"; } | {type:"user";user: {avatar_url?: … | … | …;id:string;name?: … | …;object:"user";person: {email_verified?: …; };type:"person"; } | {avatar_url?: … | … | …;bot: {owner: …;workspace_id?: …;workspace_limits?: …;workspace_name?: …; };id:string;name?: … | …;object:"user";type:"bot"; } | {id:string;object:"user"; }; };plain_text:string;type:"mention"; } | {annotations: {bold:boolean;code:boolean;color:"default"|"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";italic:boolean;strikethrough:boolean;underline:boolean; };equation: {expression:string; };href:string|null;plain_text:string;type:"equation"; })[] =richTextSchema
toggle?
Section titled “toggle?”
optionaltoggle?:object
toggle.children?
Section titled “toggle.children?”
optionalchildren?:unknown[]
toggle.color
Section titled “toggle.color”color:
"default"|"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"
toggle.rich_text
Section titled “toggle.rich_text”rich_text: ({
annotations: {bold:boolean;code:boolean;color:"default"|"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";italic:boolean;strikethrough:boolean;underline:boolean; };href:string|null;plain_text:string;text: {content:string;link: {url:string; } |null; };type:"text"; } | {annotations: {bold:boolean;code:boolean;color:"default"|"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";italic:boolean;strikethrough:boolean;underline:boolean; };href:string|null;mention: {database: {id:string; };type:"database"; } | {date: {end:string|null;start:string;time_zone?:string|null; };type:"date"; } | {link_preview: {url:string; };type:"link_preview"; } | {page: {id:string; };type:"page"; } | {template_mention: {template_mention_date: … | …;type:"template_mention_date"; } | {template_mention_user:"me";type:"template_mention_user"; };type:"template_mention"; } | {type:"user";user: {avatar_url?: … | … | …;id:string;name?: … | …;object:"user";person: {email_verified?: …; };type:"person"; } | {avatar_url?: … | … | …;bot: {owner: …;workspace_id?: …;workspace_limits?: …;workspace_name?: …; };id:string;name?: … | …;object:"user";type:"bot"; } | {id:string;object:"user"; }; };plain_text:string;type:"mention"; } | {annotations: {bold:boolean;code:boolean;color:"default"|"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";italic:boolean;strikethrough:boolean;underline:boolean; };equation: {expression:string; };href:string|null;plain_text:string;type:"equation"; })[] =richTextSchema
type:
"file"|"code"|"link_preview"|"equation"|"audio"|"bookmark"|"breadcrumb"|"bulleted_list_item"|"callout"|"child_database"|"child_page"|"column"|"column_list"|"divider"|"embed"|"heading_1"|"heading_2"|"heading_3"|"heading_4"|"image"|"numbered_list_item"|"paragraph"|"pdf"|"quote"|"synced_block"|"tab"|"table"|"table_of_contents"|"table_row"|"template"|"to_do"|"toggle"|"meeting_notes"|"unsupported"|"video"
unsupported?
Section titled “unsupported?”
optionalunsupported?:Record<string,never>
video?
Section titled “video?”
optionalvideo?: {file: {expiry_time:string;url:string; };type:"file"; } | {file_upload: {id:string; };type:"file_upload"; } | {external: {url:string; };type:"external"; }