Retrieves a database object — a container for one or more data sources — for a provided database ID. The response adheres to any limits to a connection’s capabilities.The most important fields in the database object response to highlight:
data_sources: An array of JSON objects with the id and name of every data source under the database
parent: The direct parent of the database; generally a page_id or workspace: true
Each readable entry in data_sources may also include stored sync metadata. Metadata is omitted for sources the connection cannot read, even when it can read the containing database.To find a database ID, navigate to the database URL in your Notion workspace. The ID is the 32-character alphanumeric string between the slash following the workspace name (if applicable) and the question mark.
Returns a 404 HTTP response if the database doesn’t exist or if the connection doesn’t have access to it.Each Public API endpoint can return several possible error codes. See the Error codes section of the Status codes documentation for more information.
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Headers
Notion-Version
enum<string>
required
The API version to use for this request. The latest version is 2026-03-11.
Available options:
2026-03-11
Path Parameters
database_id
string
required
ID of a Notion database, a container for one or more data sources.
Response
Option 1
Option 2
object
string
required
The database object type name.
Allowed value: "database"
id
string<uuid>
required
The ID of the database.
{"docsConfig":{"theme":"aspen","$schema":"https://mintlify.com/docs.json","name":"Notion Docs","colors":{"primary":"#000","light":"#097fe8","dark":"#0075de"},"logo":{"light":"https://mintcdn.com/notion-demo/5YdhSbldE14t5Rna/logo/light.svg?fit=max\u0026auto=format\u0026n=5YdhSbldE14t5Rna\u0026q=85\u0026s=249f5693ad929397409bf9b51d6d539d","dark":"https://mintcdn.com/notion-demo/5YdhSbldE14t5Rna/logo/dark.svg?fit=max\u0026auto=format\u0026n=5YdhSbldE14t5Rna\u0026q=85\u0026s=a8404879d171debac543bb6c1482c909","href":"/"},"favicon":"https://mintcdn.com/notion-demo/LHm9qfrJYJOPRxs6/favicon.png?fit=max\u0026auto=format\u0026n=LHm9qfrJYJOPRxs6\u0026q=85\u0026s=0668f0b3334eef21f0cdc65b390d22d9","api":{"openapi":["openapi.json","openapi-undocumented.json","openapi-adminApi.json"]},"appearance":{"default":"system"},"background":{"color":{"light":"#ffffff","dark":"#0f0f0f"}},"navbar":{"links":[{"href":"https://www.notion.com/login","label":"Log in"}],"primary":{"type":"button","label":"Developer portal","href":"https://www.notion.so/developers"}},"footer":{"socials":{"x":"https://x.com/NotionDevs","slack":"https://join.slack.com/t/notiondevs/shared_invite/zt-3u9oid9q8-HLUBmMVWYK~g9HFo4U4raA"}},"seo":{"metatags":{"og:image":"/images/og-image.png"}},"fonts":{"family":"NotionInter"},"contextual":{"options":["copy","view","chatgpt","claude","perplexity","mcp","cursor","vscode"],"display":"header"},"interaction":{"drilldown":true},"styling":{"latex":false},"navigation":{"global":{"anchors":[]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"notion-demo","hasAudioNarration":false,"actualSubdomain":"notion-demo","customDomains":["developers.notion.com"],"gitSource":{"type":"github","owner":"makenotion","repo":"notion-next","deployBranch":"main","contentDirectory":"src/server-publicApiDocs","isPrivate":true,"mountPath":"","label":""},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"REMOVE_BRANDING":{"status":"ENABLED"},"CONTEXTUAL_FEEDBACK":{"status":"ENABLED"},"CODE_SNIPPET_FEEDBACK":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6b0108b082f0182f6b575fdd","clientVersion":"0.0.4270","searchFilterCounts":[{"language":"default","tag":"API Reference","count":142},{"language":"default","tag":"Endpoints","count":135},{"language":"default","tag":"Guides","count":77},{"language":"default","tag":"Admin API","count":58},{"language":"default","tag":"Webhook events","count":31},{"language":"default","tag":"Notion API","count":23},{"language":"default","tag":"Notion MCP","count":23},{"language":"default","tag":"Agents","count":23},{"language":"default","tag":"Objects","count":18},{"language":"default","tag":"Data APIs","count":17}]},"assistantConfig":{},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"site-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"starter-pricing","enabled":true,"variant":{"name":"control","enabled":true,"payload":{"type":"string","value":"control"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"style.css","content":"@font-face{font-family:\"NotionInter\";font-weight:400;font-style:normal;font-display:optional;src:url(\"/fonts/NotionInter-Regular.woff2\") format(\"woff2\")}@font-face{font-family:\"NotionInter\";font-weight:500;font-style:normal;font-display:optional;src:url(\"/fonts/NotionInter-Medium.woff2\") format(\"woff2\")}@font-face{font-family:\"NotionInter\";font-weight:600;font-style:normal;font-display:optional;src:url(\"/fonts/NotionInter-SemiBold.woff2\") format(\"woff2\")}@font-face{font-family:\"NotionInter\";font-weight:700;font-style:normal;font-display:optional;src:url(\"/fonts/NotionInter-Bold.woff2\") format(\"woff2\")}@font-face{font-family:\"NotionInter\";font-weight:400;font-style:italic;font-display:optional;src:url(\"/fonts/NotionInter-Italic.woff2\") format(\"woff2\")}@font-face{font-family:\"NotionInter\";font-weight:500;font-style:italic;font-display:optional;src:url(\"/fonts/NotionInter-MediumItalic.woff2\") format(\"woff2\")}@font-face{font-family:\"NotionInter\";font-weight:600;font-style:italic;font-display:optional;src:url(\"/fonts/NotionInter-SemiBoldItalic.woff2\") format(\"woff2\")}@font-face{font-family:\"NotionInter\";font-weight:700;font-style:italic;font-display:optional;src:url(\"/fonts/NotionInter-BoldItalic.woff2\") format(\"woff2\")}:root{--font-notion-stack:\n\t\t\"NotionInter\", \"Inter\", -apple-system, \"system-ui\", \"Segoe UI\", Helvetica,\n\t\tArial, sans-serif, \"Apple Color Emoji\", \"Segoe UI Emoji\", \"Segoe UI Symbol\"}html,body,button,input,select,textarea,h1,h2,h3,h4,h5,h6{font-family:var(--font-notion-stack)}.card>.flex.items-center:has([data-component-part=\"card-icon\"]){align-items:flex-start}[data-component-part=\"card-content\"]{font-size:0.875rem;line-height:1.45}.navbar-link>a{background-color:transparent!important}.navbar-link>a:hover{background-color:#37352f0a!important}html.dark .navbar-link>a:hover{background-color:rgba(255, 255, 255, 0.055)!important}.bg-primary-dark.rounded-xl{border-radius:8px!important}#search-bar-entry{background-color:#37352f0a!important;color:#7d7a75!important}#search-bar-entry:hover{background-color:#37352f1a!important}#search-bar-entry svg{color:#7d7a75!important}#search-bar-entry:hover svg{color:#37352f!important}html.dark #search-bar-entry{background-color:rgba(255, 255, 255, 0.055)!important;color:rgba(255, 255, 255, 0.5)!important}html.dark #search-bar-entry:hover{background-color:rgba(255, 255, 255, 0.129)!important}html.dark #search-bar-entry svg{color:rgba(255, 255, 255, 0.5)!important}html.dark #search-bar-entry:hover svg{color:#ffffff!important}#search-bar-entry-mobile,#search-bar-entry-mobile svg{color:#7d7a75!important;background-color:#7d7a75!important}#search-bar-entry-mobile:hover,#search-bar-entry-mobile:hover svg{color:#37352f!important;background-color:#37352f!important}html.dark #search-bar-entry-mobile,html.dark #search-bar-entry-mobile svg{color:rgba(255, 255, 255, 0.5)!important;background-color:rgba(255, 255, 255, 0.5)!important}html.dark #search-bar-entry-mobile:hover,html.dark #search-bar-entry-mobile:hover svg{color:#ffffff!important;background-color:#ffffff!important}button[data-component-part=\"theme-preference-menu-trigger\"]{background-color:#37352f0a!important}button[data-component-part=\"theme-preference-menu-trigger\"]:hover,button[data-component-part=\"theme-preference-menu-trigger\"][aria-expanded=\"true\"]{background-color:#37352f1a!important}html.dark button[data-component-part=\"theme-preference-menu-trigger\"]{background-color:rgba(255, 255, 255, 0.055)!important}html.dark button[data-component-part=\"theme-preference-menu-trigger\"]:hover,html.dark button[data-component-part=\"theme-preference-menu-trigger\"][aria-expanded=\"true\"]{background-color:rgba(255, 255, 255, 0.129)!important}button[data-component-part=\"theme-preference-menu-trigger\"] svg{color:#7d7a75!important}button[data-component-part=\"theme-preference-menu-trigger\"]:hover svg,button[data-component-part=\"theme-preference-menu-trigger\"][aria-expanded=\"true\"] svg{color:#37352f!important}html.dark button[data-component-part=\"theme-preference-menu-trigger\"] svg{color:rgba(255, 255, 255, 0.5)!important}html.dark button[data-component-part=\"theme-preference-menu-trigger\"]:hover svg,html.dark button[data-component-part=\"theme-preference-menu-trigger\"][aria-expanded=\"true\"] svg{color:#ffffff!important}#navbar [class*=\"border-gray-100\"]{border-color:#e6e5e3!important}html.dark #navbar [class*=\"border-gray-800\"]{border-color:rgba(255, 255, 255, 0.094)!important}.nav-tabs-item div[class*=\"bg-gray-200\"]{background-color:#e6e5e3!important}html.dark .nav-tabs-item div[class*=\"bg-gray-700\"]{background-color:rgba(255, 255, 255, 0.18)!important}#sidebar-content[class*=\"border-gray-100\"]{border-color:#e6e5e3!important}html.dark #sidebar-content[class*=\"border-white\"]{border-color:rgba(255, 255, 255, 0.094)!important}.sidebar-nav-group-divider{background-color:#e6e5e3!important}html.dark .sidebar-nav-group-divider{background-color:rgba(255, 255, 255, 0.094)!important}html:not(.dark) :is(a,button)[class*=\"outline-offset\"][class*=\"text-gray-700\"]{color:#37352f!important}html:not(.dark) :is(a,button)[class*=\"outline-offset\"][class*=\"hover:text-gray-900\"]:hover{color:#37352f!important}html:not(.dark) :is(a,button)[class*=\"outline-offset\"] svg[class*=\"text-gray-400\"][class*=\"group-hover:text-gray-600\"]{color:#ada9a3!important}html:not(.dark) :is(a,button)[class*=\"outline-offset\"]:hover svg[class*=\"text-gray-400\"][class*=\"group-hover:text-gray-600\"]{color:#7d7a75!important}html.dark :is(a,button)[class*=\"outline-offset\"] svg[class*=\"text-gray-400\"][class*=\"group-hover:text-gray-600\"]{color:#7d7a75!important}html.dark :is(a,button)[class*=\"outline-offset\"]:hover svg[class*=\"text-gray-400\"][class*=\"group-hover:text-gray-600\"]{color:#ada9a3!important}.card[class*=\"border-gray-950\"]{border-color:#e6e5e3!important}html.dark .card[class*=\"border-white\"]{border-color:rgba(255, 255, 255, 0.094)!important}[data-component-part=\"card-title\"]{color:#37352f!important}html.dark [data-component-part=\"card-title\"]{color:#ffffff!important}[data-component-part=\"card-content\"]{color:#7d7a75!important}html.dark [data-component-part=\"card-content\"]{color:#ada9a3!important}:is(a,button)[class*=\"outline-offset\"][class*=\"rounded-xl\"]{border-radius:6px!important}a[class*=\"text-shadow\"]{text-shadow:none!important;font-weight:600!important}.sidebar-group :is(a,button,span){hyphens:none!important}html.dark :is(a,button)[class*=\"outline-offset\"][class*=\"text-primary-light\"]{color:#ffffff!important}html.dark :is(a,button)[class*=\"outline-offset\"][class*=\"bg-primary-light\"]{background-color:rgba(255, 255, 255, 0.129)!important}:is(a,button)[class*=\"outline-offset\"][class*=\"bg-primary/10\"]{background-color:#37352f1a!important}:is(a,button)[class*=\"outline-offset\"][class*=\"hover:bg-gray-600\"]:hover{background-color:#37352f0a!important}html.dark :is(a,button)[class*=\"outline-offset\"][class*=\"hover:bg-gray-200\"]:hover{background-color:rgba(255, 255, 255, 0.055)!important}html.dark #table-of-contents-content li[data-active],html.dark #table-of-contents-content li[data-active]>a{border-color:#ffffff!important}html.dark #table-of-contents-content li[data-active]>a{color:#ffffff!important}html.dark a.nav-tabs-item[class*=\"text-primary\"]{color:#ffffff!important}html.dark a.nav-tabs-item div[class*=\"bg-primary-light\"]{background-color:#ffffff!important}.eyebrow{color:#78736f!important}html.dark .eyebrow{color:#a3a39e!important}html:is([data-current-path=\"/page/changelog\"],[data-current-path=\"/page/examples\"]) #sidebar-content{display:none!important}html:is([data-current-path=\"/page/changelog\"],[data-current-path=\"/page/examples\"]) #content-container{max-width:none!important;margin-left:0!important}html:is([data-current-path=\"/page/changelog\"],[data-current-path=\"/page/examples\"]) #content-area{margin-left:0!important;margin-right:0!important}html[data-current-path=\"/page/changelog\"] [data-component-part=\"update-content\"]{font-size:1rem}.sidebar-group-header{color:#78736f!important}html.dark .sidebar-group-header{color:#a3a39e!important}html.dark [class*=\"prose-invert\"]{color:#c7c7c7!important;--tw-prose-invert-body: #c7c7c7 !important;--tw-prose-invert-bullets: #c7c7c7 !important;--tw-prose-invert-counters: #c7c7c7 !important}html.dark h1#page-title{color:#ffffff!important}html.dark #header p{color:#c7c7c7!important}html.dark #table-of-contents-content a{color:#c7c7c7!important}html.dark .sidebar-group a:not([class*=\"text-shadow\"]),html.dark .sidebar-group button{color:#c7c7c7!important}html.dark #table-of-contents-content a:hover,html.dark .sidebar-group a:not([class*=\"text-shadow\"]):hover,html.dark .sidebar-group button:hover,html.dark a.nav-tabs-item:hover{color:#ffffff!important}#content a.link{color:inherit!important;text-decoration:underline!important;text-decoration-color:rgba(55, 53, 47, 0.25)!important;text-underline-offset:3px!important;text-decoration-thickness:1px!important;border-bottom:0!important;font-weight:inherit!important}#content a.link:hover{color:inherit!important;text-decoration-color:currentColor!important}html.dark #content a.link{text-decoration-color:rgba(255, 255, 255, 0.25)!important}html.dark #content a.link:hover{text-decoration-color:currentColor!important}.callout[class*=\"bg-blue\"]{background-color:#e5f2fc!important;border-color:#b6d4f3!important}.callout[class*=\"bg-blue\"] [data-component-part=\"callout-icon\"],.callout[class*=\"bg-blue\"] [data-component-part=\"callout-icon\"] svg{color:#2783de!important}.callout[class*=\"bg-blue\"] [data-component-part=\"callout-content\"]{color:#355f8b!important}.callout[class*=\"bg-green\"]{background-color:#e8f1ec!important;border-color:#bed9c9!important}.callout[class*=\"bg-green\"] [data-component-part=\"callout-icon\"],.callout[class*=\"bg-green\"] [data-component-part=\"callout-icon\"] svg{color:#46a171!important}.callout[class*=\"bg-green\"] [data-component-part=\"callout-content\"]{color:#37674c!important}.callout[class*=\"bg-yellow\"]{background-color:#f9f3dc!important;border-color:#e8d497!important}.callout[class*=\"bg-yellow\"] [data-component-part=\"callout-icon\"],.callout[class*=\"bg-yellow\"] [data-component-part=\"callout-icon\"] svg{color:#d8a32f!important}.callout[class*=\"bg-yellow\"] [data-component-part=\"callout-content\"]{color:#836426!important}.callout[class*=\"bg-red\"]{background-color:#fce9e7!important;border-color:#f0c5be!important}.callout[class*=\"bg-red\"] [data-component-part=\"callout-icon\"],.callout[class*=\"bg-red\"] [data-component-part=\"callout-icon\"] svg{color:#e56458!important}.callout[class*=\"bg-red\"] [data-component-part=\"callout-content\"]{color:#924943!important}.callout[class*=\"bg-neutral\"]{background-color:#f0efed!important;border-color:#e6e5e3!important}.callout[class*=\"bg-neutral\"] [data-component-part=\"callout-icon\"],.callout[class*=\"bg-neutral\"] [data-component-part=\"callout-icon\"] svg{color:#5f5e59!important}.callout[class*=\"bg-neutral\"] [data-component-part=\"callout-content\"]{color:#494846!important}html.dark .callout[class*=\"bg-blue\"]{background-color:rgba(39, 131, 222, 0.12)!important;border-color:rgba(39, 131, 222, 0.3)!important}html.dark .callout[class*=\"bg-green\"]{background-color:rgba(70, 161, 113, 0.12)!important;border-color:rgba(70, 161, 113, 0.3)!important}html.dark .callout[class*=\"bg-yellow\"]{background-color:rgba(216, 163, 47, 0.12)!important;border-color:rgba(216, 163, 47, 0.3)!important}html.dark .callout[class*=\"bg-red\"]{background-color:rgba(229, 100, 88, 0.12)!important;border-color:rgba(229, 100, 88, 0.3)!important}html.dark .callout[class*=\"bg-neutral\"]{background-color:rgba(255, 255, 255, 0.05)!important;border-color:rgba(255, 255, 255, 0.12)!important}html.dark .callout[class*=\"bg-blue\"] [data-component-part=\"callout-content\"]{color:#9dc0ea!important}html.dark .callout[class*=\"bg-green\"] [data-component-part=\"callout-content\"]{color:#a6c7b4!important}html.dark .callout[class*=\"bg-yellow\"] [data-component-part=\"callout-content\"]{color:#e2ca88!important}html.dark .callout[class*=\"bg-red\"] [data-component-part=\"callout-content\"]{color:#e0aea6!important}html.dark .callout[class*=\"bg-neutral\"] [data-component-part=\"callout-content\"]{color:#bcbab6!important}html.dark .callout[class*=\"bg-neutral\"] [data-component-part=\"callout-icon\"],html.dark .callout[class*=\"bg-neutral\"] [data-component-part=\"callout-icon\"] svg{color:#ada9a3!important}.callout a.link,#content .callout a.link{color:inherit!important;text-decoration:underline!important;border-bottom:0!important}.callout a.link:hover,#content .callout a.link:hover{color:inherit!important;text-decoration:underline!important}[data-component-part=\"card-icon\"] img{filter:brightness(0) saturate(100%) invert(31%) sepia(85%) saturate(2280%)\n\t\thue-rotate(196deg) brightness(96%) contrast(101%)}html.dark [data-component-part=\"card-icon\"] img{filter:brightness(0) saturate(100%) invert(45%) sepia(98%) saturate(1480%)\n\t\thue-rotate(196deg) brightness(101%) contrast(96%)}[data-component-part=\"card-icon\"]>svg{width:1.25rem!important;height:1.25rem!important;mask-size:contain!important;-webkit-mask-size:contain!important}.card{transition:box-shadow 180ms ease-out,\n\t\tborder-color 180ms ease-out}.card:hover{--tw-ring-shadow: 0 0 #0000 !important;--tw-ring-color: transparent !important;border-color:transparent!important;box-shadow:0 0 0 1px rgba(0, 0, 0, 0.06),\n\t\t0 4px 10px rgba(15, 15, 15, 0.05),\n\t\t0 1px 3px rgba(15, 15, 15, 0.04)!important}html.dark .card:hover{--tw-ring-shadow: 0 0 #0000 !important;--tw-ring-color: transparent !important;border-color:rgba(255, 255, 255, 0.18)!important;box-shadow:none!important}a[class*=\"border-gray-200/70\"][class*=\"rounded-xl\"][class*=\"py-3\"][class*=\"px-4\"]{border:0!important;padding:0!important}[data-component-part=\"code-block-root\"],[data-component-part=\"code-block-root\"] pre,[data-component-part=\"code-block-root\"] code,[data-component-part=\"code-block-root\"] code *{font-size:12px!important;line-height:20px!important}#page-context-menu [class*=\"rounded-l-xl\"]{border-radius:6px 0 0 6px!important}#page-context-menu [class*=\"rounded-r-xl\"]{border-radius:0 6px 6px 0!important}#page-context-menu [class*=\"text-sm\"]{font-size:12px!important}#page-context-menu :is(button,a)[class*=\"bg-gray\"],#page-context-menu :is(button,a)[class*=\"border-gray\"]{background-color:transparent!important;border-color:#e6e5e3!important}#page-context-menu :is(button,a):hover{background-color:#37352f0a!important}html.dark #page-context-menu :is(button,a)[class*=\"bg-gray\"],html.dark #page-context-menu :is(button,a)[class*=\"border-gray\"]{border-color:rgba(255, 255, 255, 0.094)!important}html.dark #page-context-menu :is(button,a):hover{background-color:rgba(255, 255, 255, 0.055)!important}[data-component-part=\"update-label\"]{background-color:#f7f6f3!important;color:#5f5e59!important;font-size:14px!important;line-height:20px!important;font-weight:400!important}html.dark [data-component-part=\"update-label\"]{background-color:rgba(255, 255, 255, 0.04)!important;color:#bcbab6!important}[class*=\"text-tooltip-foreground\"]{background-color:#1f1f1d!important;color:#ffffff!important;border-color:#1f1f1d!important}"}]}
{"page":{"pagePath":"reference/retrieve-database","slug":"/reference/retrieve-database","pageMetadata":{"openapi":"get /v1/databases/{database_id}","title":"Retrieve a database","description":null,"href":"/reference/retrieve-database"},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,li:`li`,p:`p`,ul:`ul`,..._provideComponents(),...props.components},{Frame,Heading,OptimizedImage}=_components;if(!Frame)_missingMdxReference(`Frame`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!OptimizedImage)_missingMdxReference(`OptimizedImage`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`Retrieves a `,_jsx(_components.a,{href:`/reference/database`,children:`database object`}),` — a container for one or more `,_jsx(_components.a,{href:`/reference/data-source`,children:`data sources`}),` — for a provided database ID. The response adheres to any limits to a connection’s capabilities.`]}),`\n`,_jsx(_components.p,{children:`The most important fields in the database object response to highlight:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`data_sources`}),`: An array of JSON objects with the `,_jsx(_components.code,{children:`id`}),` and `,_jsx(_components.code,{children:`name`}),` of every data source under the database`,`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`These data source IDs can be used with the `,_jsx(_components.a,{href:`/reference/retrieve-a-data-source`,children:`Retrieve a data source`}),`, `,_jsx(_components.a,{href:`/reference/update-a-data-source`,children:`Update a data source`}),`, and `,_jsx(_components.a,{href:`/reference/query-a-data-source`,children:`Query a data source`}),` APIs`]}),`\n`]}),`\n`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`parent`}),`: The direct parent of the database; generally a `,_jsx(_components.code,{children:`page_id`}),` or `,_jsx(_components.code,{children:`workspace: true`})]}),`\n`]}),`\n`,_jsxs(_components.p,{children:[`Each readable entry in `,_jsx(_components.code,{children:`data_sources`}),` may also include `,_jsx(_components.a,{href:`/reference/data-source#sync-metadata`,children:`stored sync metadata`}),`. Metadata is omitted for sources the connection cannot read, even when it can read the containing database.`]}),`\n`,_jsx(_components.p,{children:`To find a database ID, navigate to the database URL in your Notion workspace. The ID is the 32-character alphanumeric string between the slash following the workspace name (if applicable) and the question mark.`}),`\n`,_jsx(Frame,{caption:`Notion database ID`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/notion-demo/S-I3qLQnwRa7HjdK/images/reference/image-2.png?fit=max\u0026auto=format\u0026n=S-I3qLQnwRa7HjdK\u0026q=85\u0026s=3b244159a0dd487845b013fdfab22954`,alt:`Notion database ID`,\"data-og-width\":`1502`,width:`1502`,\"data-og-height\":`128`,height:`128`,\"data-path\":`images/reference/image-2.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/notion-demo/S-I3qLQnwRa7HjdK/images/reference/image-2.png?w=280\u0026fit=max\u0026auto=format\u0026n=S-I3qLQnwRa7HjdK\u0026q=85\u0026s=99238140eb06b3f3fd067cca66461387 280w, https://mintcdn.com/notion-demo/S-I3qLQnwRa7HjdK/images/reference/image-2.png?w=560\u0026fit=max\u0026auto=format\u0026n=S-I3qLQnwRa7HjdK\u0026q=85\u0026s=2d228d192ef2aac1a5b8fb0c2d749c0a 560w, https://mintcdn.com/notion-demo/S-I3qLQnwRa7HjdK/images/reference/image-2.png?w=840\u0026fit=max\u0026auto=format\u0026n=S-I3qLQnwRa7HjdK\u0026q=85\u0026s=12d59b1cfd62bb99248a6947f03d9590 840w, https://mintcdn.com/notion-demo/S-I3qLQnwRa7HjdK/images/reference/image-2.png?w=1100\u0026fit=max\u0026auto=format\u0026n=S-I3qLQnwRa7HjdK\u0026q=85\u0026s=6ee6efcbbe2b39d842a0e2951d91bb4d 1100w, https://mintcdn.com/notion-demo/S-I3qLQnwRa7HjdK/images/reference/image-2.png?w=1650\u0026fit=max\u0026auto=format\u0026n=S-I3qLQnwRa7HjdK\u0026q=85\u0026s=515e6b0c0fe273fdc7cf2369be22f0d8 1650w, https://mintcdn.com/notion-demo/S-I3qLQnwRa7HjdK/images/reference/image-2.png?w=2500\u0026fit=max\u0026auto=format\u0026n=S-I3qLQnwRa7HjdK\u0026q=85\u0026s=6f8c152d49c69804ebdbc55221b96c01 2500w`})}),`\n`,_jsxs(_components.p,{children:[`Refer to the `,_jsx(_components.a,{href:`/guides/data-apis/working-with-databases`,children:`Working with databases`}),` guide for more details.`]}),`\n`,_jsx(Heading,{level:`3`,id:`errors`,children:`Errors`}),`\n`,_jsx(_components.p,{children:`Returns a 404 HTTP response if the database doesn’t exist or if the connection doesn’t have access to it.`}),`\n`,_jsxs(_components.p,{children:[`Each Public API endpoint can return several possible error codes. See the `,_jsx(_components.a,{href:`/reference/status-codes#error-codes`,children:`Error codes section`}),` of the Status codes documentation for more information.`]}),`\n`,_jsx(Heading,{level:`3`,id:`additional-resources`,children:`Additional resources`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:_jsx(_components.a,{href:`/guides/connections-and-tokens/overview#content-access`,children:`How to share a database with your connection`})}),`\n`,_jsx(_components.li,{children:_jsx(_components.a,{href:`/guides/data-apis/working-with-databases`,children:`Working with databases guide`})}),`\n`]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"openapi":"get /v1/databases/{database_id}","title":"Retrieve a database","description":null,"href":"/reference/retrieve-database"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Errors","slug":"errors","depth":3,"children":[]},{"title":"Additional resources","slug":"additional-resources","depth":3,"children":[]}],"codeExamples":{}},"jsLinks":["/_mintlify/custom/notion-demo/f3af24179eebc764/mcp-section-label.js","/_mintlify/custom/notion-demo/96b92b5a9cb7e11c/mcp-tool-section-redirects.js"],"openApiReferenceData":{"operation":{"summary":"Retrieve a database","operationId":"retrieve-database","tags":["Databases"],"x-codeSamples":[{"lang":"javascript","label":"TypeScript SDK","source":"import { Client } from \"@notionhq/client\"\n\nconst notion = new Client({ auth: process.env.NOTION_API_KEY })\n\nconst response = await notion.databases.retrieve({\n database_id: \"d9824bdc-8445-4327-be8b-5b47500af6ce\"\n})"}],"x-notion-docs-ref":"https://developers.notion.com/reference/retrieve-database","x-notion-docs-guides":["https://developers.notion.com/guides/data-apis/working-with-databases"],"parameters":["d67cb272-4909-4486-8bcc-2f96572101e2","5ebbfbb1-9c0e-4305-b2a2-91ea33888847"],"responses":{"200":"a91f86cc-bbc5-4c72-985c-802e265106f2","400":"d771d840-541d-40d4-ae38-b383abda03cf","401":"51c96720-df4c-44e7-a21e-7a49508d2eae","403":"51e0716a-85b5-44d3-9637-3729bd4f5457","404":"c5f4d3f4-252b-42b1-8be4-8bec46621962","406":"6c741e32-36c1-4923-826b-2f287a81a3e7","409":"6dbdbc22-dec9-4b7e-a7ef-96bd97deae14","429":"5f952344-bb71-4a8b-846c-fc20ae6ea6b2","500":"11a6d732-f6e8-475d-b60d-88f86330fdfb","503":"1cea220f-94e2-4638-937e-8d6679c62fd9","504":"55ea7a6b-67a1-405c-8667-a78fc456b79b","529":"c7a29a61-44c1-4462-810d-ed68b77fe767"},"method":"get","type":"path","servers":["2c852185-817e-41b9-a119-a2d9c7a56bef"],"security":["23c7697b-01d6-4756-9e53-15c190c2a020"],"path":"/https/developers.notion.com/v1/databases/{database_id}","baseUrlOptions":["https://api.notion.com"],"title":"Retrieve a database","description":"","codeSamples":[{"label":"TypeScript SDK","lang":"javascript","source":"import { Client } from \"@notionhq/client\"\n\nconst notion = new Client({ auth: process.env.NOTION_API_KEY })\n\nconst response = await notion.databases.retrieve({\n database_id: \"d9824bdc-8445-4327-be8b-5b47500af6ce\"\n})"}],"requiredOnlyExamples":false,"requestExampleType":"codeSamples","responseExampleType":"generated"},"dependencies":{"parameters":{"d67cb272-4909-4486-8bcc-2f96572101e2":{"name":"database_id","in":"path","required":true,"schema":{"type":"string","description":"ID of a Notion database, a container for one or more data sources.","isRequired":true,"uniqueKey":"","typeLabel":"string"}},"5ebbfbb1-9c0e-4305-b2a2-91ea33888847":{"name":"Notion-Version","in":"header","required":true,"schema":{"enum":["2026-03-11"],"type":"string","isRequired":true,"description":"The [API version](/reference/versioning) to use for this request. The latest version is `2026-03-11`.","uniqueKey":"","typeLabel":"enum\u003cstring>"},"description":"The [API version](/reference/versioning) to use for this request. The latest version is `2026-03-11`."}},"responses":{"a91f86cc-bbc5-4c72-985c-802e265106f2":{"description":"","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["object","id"],"properties":{"object":{"type":"string","const":"database","description":"The database object type name.","isRequired":true,"uniqueKey":"oneOf.0.object","typeLabel":"string"},"id":{"type":"string","format":"uuid","description":"The ID of the database.","isRequired":true,"uniqueKey":"oneOf.0.id","typeLabel":"string\u003cuuid>"}},"additionalProperties":false,"uniqueKey":"oneOf.0","typeLabel":"object"},{"type":"object","required":["object","id","title","description","parent","is_inline","database_type","in_trash","is_locked","show_data_source_title","created_time","last_edited_time","data_sources","icon","cover","url","public_url"],"properties":{"object":{"type":"string","const":"database","description":"The database object type name.","isRequired":true,"uniqueKey":"oneOf.1.object","typeLabel":"string"},"id":{"type":"string","format":"uuid","description":"The ID of the database.","isRequired":true,"uniqueKey":"oneOf.1.id","typeLabel":"string\u003cuuid>"},"title":{"type":"array","items":{"oneOf":[{"type":"object","title":"Text","required":["type","text","plain_text","href","annotations"],"properties":{"plain_text":{"type":"string","description":"The plain text content of the rich text object, without any styling.","isRequired":true,"uniqueKey":"oneOf.1.title.items.[INDEX].oneOf.0.plain_text","typeLabel":"string"},"href":{"oneOf":[{"type":"string","description":"A URL that the rich text object links to or mentions.","isRequired":true,"uniqueKey":"oneOf.1.title.items.[INDEX].oneOf.0.href.oneOf.0","typeLabel":"string"},{"type":"null","description":"A URL that the rich text object links to or mentions.","isRequired":true,"uniqueKey":"oneOf.1.title.items.[INDEX].oneOf.0.href.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"oneOf.1.title.items.[INDEX].oneOf.0.href","typeLabel":"string | null"},"annotations":{"type":"object","properties":{"bold":{"type":"boolean","isRequired":true,"uniqueKey":"oneOf.1.title.items.[INDEX].oneOf.0.annotations.bold","typeLabel":"boolean"},"italic":{"type":"boolean","isRequired":true,"uniqueKey":"oneOf.1.title.items.[INDEX].oneOf.0.annotations.italic","typeLabel":"boolean"},"strikethrough":{"type":"boolean","isRequired":true,"uniqueKey":"oneOf.1.title.items.[INDEX].oneOf.0.annotations.strikethrough","typeLabel":"boolean"},"underline":{"type":"boolean","isRequired":true,"uniqueKey":"oneOf.1.title.items.[INDEX].oneOf.0.annotations.underline","typeLabel":"boolean"},"code":{"type":"boolean","isRequired":true,"uniqueKey":"oneOf.1.title.items.[INDEX].oneOf.0.annotations.code","typeLabel":"boolean"},"color":{"type":"string","enum":["default","gray","brown","orange","yellow","green","blue","purple","pink","red","default_background","gray_background","brown_background","orange_background","yellow_background","green_background","blue_background","purple_background","pink_background","red_background"],"description":"One of: `default`, `gray`, `brown`, `orange`, `yellow`, `green`, `blue`, `purple`, `pink`, `red`, `default_background`, `gray_background`, `brown_background`, `orange_background`, `yellow_background`, `green_background`, `blue_background`, `purple_background`, `pink_background`, `red_background`","isRequired":true,"uniqueKey":"oneOf.1.title.items.[INDEX].oneOf.0.annotations.color","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"required":["bold","italic","strikethrough","underline","code","color"],"description":"All rich text objects contain an annotations object that sets the styling for the rich text.","isRequired":true,"uniqueKey":"oneOf.1.title.items.[INDEX].oneOf.0.annotations","typeLabel":"object"},"type":{"type":"string","const":"text","description":"Always `text`","isRequired":true,"uniqueKey":"oneOf.1.title.items.[INDEX].oneOf.0.type","typeLabel":"string"},"text":{"type":"object","properties":{"content":{"type":"string","maxLength":2000,"description":"The actual text content of the text.","isRequired":true,"uniqueKey":"oneOf.1.title.items.[INDEX].oneOf.0.text.content","typeLabel":"string"},"link":{"oneOf":[{"type":"object","description":"An object with information about any inline link in this text, if included.","required":["url"],"properties":{"url":{"type":"string","examples":["https://www.notion.com"],"description":"The URL of the link.","isRequired":true,"uniqueKey":"oneOf.1.title.items.[INDEX].oneOf.0.text.link.oneOf.0.url","typeLabel":"string"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"oneOf.1.title.items.[INDEX].oneOf.0.text.link.oneOf.0","typeLabel":"object"},{"type":"null","description":"An object with information about any inline link in this text, if included.","isRequired":true,"uniqueKey":"oneOf.1.title.items.[INDEX].oneOf.0.text.link.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"oneOf.1.title.items.[INDEX].oneOf.0.text.link","typeLabel":"object | null"}},"additionalProperties":false,"required":["content","link"],"description":"If a rich text object's type value is `text`, then the corresponding text field contains an object including the text content and any inline link.","isRequired":true,"uniqueKey":"oneOf.1.title.items.[INDEX].oneOf.0.text","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"oneOf.1.title.items.[INDEX].oneOf.0","typeLabel":"Text · object"},{"type":"object","title":"Mention","required":["type","mention","plain_text","href","annotations"],"properties":{"plain_text":{"type":"string","description":"The plain text content of the rich text object, without any styling.","isRequired":true,"uniqueKey":"oneOf.1.title.items.[INDEX].oneOf.1.plain_text","typeLabel":"string"},"href":{"oneOf":[{"type":"string","description":"A URL that the rich text object links to or mentions.","isRequired":true,"uniqueKey":"oneOf.1.title.items.[INDEX].oneOf.1.href.oneOf.0","typeLabel":"string"},{"type":"null","description":"A URL that the rich text object links to or mentions.","isRequired":true,"uniqueKey":"oneOf.1.title.items.[INDEX].oneOf.1.href.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"oneOf.1.title.items.[INDEX].oneOf.1.href","typeLabel":"string | null"},"annotations":{"type":"object","properties":{"bold":{"type":"boolean","isRequired":true,"uniqueKey":"oneOf.1.title.items.[INDEX].oneOf.1.annotations.bold","typeLabel":"boolean"},"italic":{"type":"boolean","isRequired":true,"uniqueKey":"oneOf.1.title.items.[INDEX].oneOf.1.annotations.italic","typeLabel":"boolean"},"strikethrough":{"type":"boolean","isRequired":true,"uniqueKey":"oneOf.1.title.items.[INDEX].oneOf.1.annotations.strikethrough","typeLabel":"boolean"},"underline":{"type":"boolean","isRequired":true,"uniqueKey":"oneOf.1.title.items.[INDEX].oneOf.1.annotations.underline","typeLabel":"boolean"},"code":{"type":"boolean","isRequired":true,"uniqueKey":"oneOf.1.title.items.[INDEX].oneOf.1.annotations.code","typeLabel":"boolean"},"color":{"type":"string","enum":["default","gray","brown","orange","yellow","green","blue","purple","pink","red","default_background","gray_background","brown_background","orange_background","yellow_background","green_background","blue_background","purple_background","pink_background","red_background"],"description":"One of: `default`, `gray`, `brown`, `orange`, `yellow`, `green`, `blue`, `purple`, `pink`, `red`, `default_background`, `gray_background`, `brown_background`, `orange_background`, `yellow_background`, `green_background`, `blue_background`, `purple_background`, `pink_background`, `red_background`","isRequired":true,"uniqueKey":"oneOf.1.title.items.[INDEX].oneOf.1.annotations.color","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"required":["bold","italic","strikethrough","underline","code","color"],"description":"All rich text objects contain an annotations object that sets the styling for the rich text.","isRequired":true,"uniqueKey":"oneOf.1.title.items.[INDEX].oneOf.1.annotations","typeLabel":"object"},"type":{"type":"string","const":"mention","description":"Always `mention`","isRequired":true,"uniqueKey":"oneOf.1.title.items.[INDEX].oneOf.1.type","typeLabel":"string"},"mention":{"oneOf":[{"type":"object","title":"User","description":"Mention objects represent an inline mention of a database, date, link preview mention, page, template mention, or user. A mention is created in the Notion UI when a user types `@` followed by the name of the reference.","required":["type","user"],"properties":{"type":{"type":"string","const":"user","description":"Always `user`","isRequired":true,"uniqueKey":"oneOf.1.title.items.[INDEX].oneOf.1.mention.oneOf.0.type","typeLabel":"string"},"user":{"oneOf":[{"type":"object","description":"Details of the user mention.","required":["id","object"],"properties":{"id":{"type":"string","format":"uuid","isRequired":true,"uniqueKey":"oneOf.1.title.items.[INDEX].oneOf.1.mention.oneOf.0.user.oneOf.0.id","typeLabel":"string\u003cuuid>"},"object":{"type":"string","const":"user","description":"Always `user`","isRequired":true,"uniqueKey":"oneOf.1.title.items.[INDEX].oneOf.1.mention.oneOf.0.user.oneOf.0.object","typeLabel":"string"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"oneOf.1.title.items.[INDEX].oneOf.1.mention.oneOf.0.user.oneOf.0","typeLabel":"object"},{"type":"object","title":"Person","description":"Details of the user mention.","required":["type","person","id","object","name","avatar_url"],"properties":{"id":{"type":"string","format":"uuid","description":"The ID of the user.","isRequired":true,"uniqueKey":"oneOf.1.title.items.[INDEX].oneOf.1.mention.oneOf.0.user.oneOf.1.id","typeLabel":"string\u003cuuid>"},"object":{"type":"string","const":"user","description":"The user object type name.","isRequired":true,"uniqueKey":"oneOf.1.title.items.[INDEX].oneOf.1.mention.oneOf.0.user.oneOf.1.object","typeLabel":"string"},"name":{"oneOf":[{"type":"string","description":"The name of the user.","isRequired":true,"uniqueKey":"oneOf.1.title.items.[INDEX].oneOf.1.mention.oneOf.0.user.oneOf.1.name.oneOf.0","typeLabel":"string"},{"type":"null","description":"The name of the user.","isRequired":true,"uniqueKey":"oneOf.1.title.items.[INDEX].oneOf.1.mention.oneOf.0.user.oneOf.1.name.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"oneOf.1.title.items.[INDEX].oneOf.1.mention.oneOf.0.user.oneOf.1.name","typeLabel":"string | null"},"avatar_url":{"oneOf":[{"type":"string","description":"The avatar URL of the user.","isRequired":true,"uniqueKey":"oneOf.1.title.items.[INDEX].oneOf.1.mention.oneOf.0.user.oneOf.1.avatar_url.oneOf.0","typeLabel":"string"},{"type":"null","description":"The avatar URL of the user.","isRequired":true,"uniqueKey":"oneOf.1.title.items.[INDEX].oneOf.1.mention.oneOf.0.user.oneOf.1.avatar_url.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"oneOf.1.title.items.[INDEX].oneOf.1.mention.oneOf.0.user.oneOf.1.avatar_url","typeLabel":"string | null"},"type":{"type":"string","const":"person","description":"Indicates this user is a person.","isRequired":true,"uniqueKey":"oneOf.1.title.items.[INDEX].oneOf.1.mention.oneOf.0.user.oneOf.1.type","typeLabel":"string"},"person":{"type":"object","properties":{"email":{"type":"string","description":"The email of the person.","uniqueKey":"oneOf.1.title.items.[INDEX].oneOf.1.mention.oneOf.0.user.oneOf.1.person.email","typeLabel":"string"},"email_verified":{"type":"boolean","description":"Whether the person's email is verified.","uniqueKey":"oneOf.1.title.items.[INDEX].oneOf.1.mention.oneOf.0.user.oneOf.1.person.email_verified","typeLabel":"boolean"}},"additionalProperties":false,"description":"Details about the person, when the `type` of the user is `person`.","isRequired":true,"uniqueKey":"oneOf.1.title.items.[INDEX].oneOf.1.mention.oneOf.0.user.oneOf.1.person","typeLabel":"object"},"agent_id":{"type":"string","format":"uuid","description":"The ID of the Custom Agent this bot acts for. Only present when the user is a Custom Agent's bot.","uniqueKey":"oneOf.1.title.items.[INDEX].oneOf.1.mention.oneOf.0.user.oneOf.1.agent_id","typeLabel":"string\u003cuuid>"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"oneOf.1.title.items.[INDEX].oneOf.1.mention.oneOf.0.user.oneOf.1","typeLabel":"Person · object"},{"type":"object","title":"Bot","description":"Details of the user mention.","required":["type","bot","id","object","name","avatar_url"],"properties":{"id":{"type":"string","format":"uuid","description":"The ID of the user.","isRequired":true,"uniqueKey":"oneOf.1.title.items.[INDEX].oneOf.1.mention.oneOf.0.user.oneOf.2.id","typeLabel":"string\u003cuuid>"},"object":{"type":"string","const":"user","description":"The user object type name.","isRequired":true,"uniqueKey":"oneOf.1.title.items.[INDEX].oneOf.1.mention.oneOf.0.user.oneOf.2.object","typeLabel":"string"},"name":{"oneOf":[{"type":"string","description":"The name of the user.","isRequired":true,"uniqueKey":"oneOf.1.title.items.[INDEX].oneOf.1.mention.oneOf.0.user.oneOf.2.name.oneOf.0","typeLabel":"string"},{"type":"null","description":"The name of the user.","isRequired":true,"uniqueKey":"oneOf.1.title.items.[INDEX].oneOf.1.mention.oneOf.0.user.oneOf.2.name.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"oneOf.1.title.items.[INDEX].oneOf.1.mention.oneOf.0.user.oneOf.2.name","typeLabel":"string | null"},"avatar_url":{"oneOf":[{"type":"string","description":"The avatar URL of the user.","isRequired":true,"uniqueKey":"oneOf.1.title.items.[INDEX].oneOf.1.mention.oneOf.0.user.oneOf.2.avatar_url.oneOf.0","typeLabel":"string"},{"type":"null","description":"The avatar URL of the user.","isRequired":true,"uniqueKey":"oneOf.1.title.items.[INDEX].oneOf.1.mention.oneOf.0.user.oneOf.2.avatar_url.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"oneOf.1.title.items.[INDEX].oneOf.1.mention.oneOf.0.user.oneOf.2.avatar_url","typeLabel":"string | null"},"type":{"type":"string","const":"bot","description":"Indicates this user is a bot.","isRequired":true,"uniqueKey":"oneOf.1.title.items.[INDEX].oneOf.1.mention.oneOf.0.user.oneOf.2.type","typeLabel":"string"},"bot":{"oneOf":[{"type":"object","description":"Details about the bot, when the `type` of the user is `bot`.","properties":{},"additionalProperties":false,"isRequired":true,"uniqueKey":"oneOf.1.title.items.[INDEX].oneOf.1.mention.oneOf.0.user.oneOf.2.bot.oneOf.0","typeLabel":"object"},{"type":"object","description":"Details about the bot, when the `type` of the user is `bot`.","required":["owner","workspace_id","workspace_limits","workspace_name"],"properties":{"owner":{"type":"any","description":"Details about the owner of the bot.","isRequired":true,"uniqueKey":"oneOf.1.title.items.[INDEX].oneOf.1.mention.oneOf.0.user.oneOf.2.bot.oneOf.1.owner","typeLabel":"any"},"workspace_id":{"type":"string","description":"The ID of the bot's workspace.","isRequired":true,"uniqueKey":"oneOf.1.title.items.[INDEX].oneOf.1.mention.oneOf.0.user.oneOf.2.bot.oneOf.1.workspace_id","typeLabel":"string"},"workspace_limits":{"type":"object","properties":{"max_file_upload_size_in_bytes":{"type":"integer","minimum":0,"description":"The maximum allowable size of a file upload, in bytes","isRequired":true,"uniqueKey":"oneOf.1.title.items.[INDEX].oneOf.1.mention.oneOf.0.user.oneOf.2.bot.oneOf.1.workspace_limits.max_file_upload_size_in_bytes","typeLabel":"integer"}},"additionalProperties":false,"required":["max_file_upload_size_in_bytes"],"description":"Limits and restrictions that apply to the bot's workspace","isRequired":true,"uniqueKey":"oneOf.1.title.items.[INDEX].oneOf.1.mention.oneOf.0.user.oneOf.2.bot.oneOf.1.workspace_limits","typeLabel":"object"},"workspace_name":{"type":"any","description":"The name of the bot's workspace.","isRequired":true,"uniqueKey":"oneOf.1.title.items.[INDEX].oneOf.1.mention.oneOf.0.user.oneOf.2.bot.oneOf.1.workspace_name","typeLabel":"any"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"oneOf.1.title.items.[INDEX].oneOf.1.mention.oneOf.0.user.oneOf.2.bot.oneOf.1","typeLabel":"object"}],"isRequired":true,"uniqueKey":"oneOf.1.title.items.[INDEX].oneOf.1.mention.oneOf.0.user.oneOf.2.bot","typeLabel":"object"},"agent_id":{"type":"string","format":"uuid","description":"The ID of the Custom Agent this bot acts for. Only present when the user is a Custom Agent's bot.","uniqueKey":"oneOf.1.title.items.[INDEX].oneOf.1.mention.oneOf.0.user.oneOf.2.agent_id","typeLabel":"string\u003cuuid>"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"oneOf.1.title.items.[INDEX].oneOf.1.mention.oneOf.0.user.oneOf.2","typeLabel":"Bot · object"}],"isRequired":true,"uniqueKey":"oneOf.1.title.items.[INDEX].oneOf.1.mention.oneOf.0.user","typeLabel":"object | Person · object | Bot · object"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"oneOf.1.title.items.[INDEX].oneOf.1.mention.oneOf.0","typeLabel":"User · object"},{"type":"object","title":"Date","description":"Mention objects represent an inline mention of a database, date, link preview mention, page, template mention, or user. A mention is created in the Notion UI when a user types `@` followed by the name of the reference.","required":["type","date"],"properties":{"type":{"type":"string","const":"date","description":"Always `date`","isRequired":true,"uniqueKey":"oneOf.1.title.items.[INDEX].oneOf.1.mention.oneOf.1.type","typeLabel":"string"},"date":{"type":"object","properties":{"start":{"type":"string","format":"date","description":"The start date of the date object.","isRequired":true,"uniqueKey":"oneOf.1.title.items.[INDEX].oneOf.1.mention.oneOf.1.date.start","typeLabel":"string\u003cdate>"},"end":{"oneOf":[{"type":"string","description":"The end date of the date object, if any.","format":"date","isRequired":true,"uniqueKey":"oneOf.1.title.items.[INDEX].oneOf.1.mention.oneOf.1.date.end.oneOf.0","typeLabel":"string\u003cdate>"},{"type":"null","description":"The end date of the date object, if any.","isRequired":true,"uniqueKey":"oneOf.1.title.items.[INDEX].oneOf.1.mention.oneOf.1.date.end.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"oneOf.1.title.items.[INDEX].oneOf.1.mention.oneOf.1.date.end","typeLabel":"string\u003cdate> | null"},"time_zone":{"oneOf":[{"type":"string","description":"The time zone of the date object.","example":"Africa/Abidjan","isRequired":true,"uniqueKey":"oneOf.1.title.items.[INDEX].oneOf.1.mention.oneOf.1.date.time_zone.oneOf.0","typeLabel":"string"},{"type":"null","description":"The time zone of the date object.","isRequired":true,"uniqueKey":"oneOf.1.title.items.[INDEX].oneOf.1.mention.oneOf.1.date.time_zone.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"oneOf.1.title.items.[INDEX].oneOf.1.mention.oneOf.1.date.time_zone","typeLabel":"string | null"}},"additionalProperties":false,"required":["start","end","time_zone"],"description":"Details of the date mention.","isRequired":true,"uniqueKey":"oneOf.1.title.items.[INDEX].oneOf.1.mention.oneOf.1.date","typeLabel":"object"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"oneOf.1.title.items.[INDEX].oneOf.1.mention.oneOf.1","typeLabel":"Date · object"},{"type":"object","title":"Link Preview","description":"Mention objects represent an inline mention of a database, date, link preview mention, page, template mention, or user. A mention is created in the Notion UI when a user types `@` followed by the name of the reference.","required":["type","link_preview"],"properties":{"type":{"type":"string","const":"link_preview","description":"Always `link_preview`","isRequired":true,"uniqueKey":"oneOf.1.title.items.[INDEX].oneOf.1.mention.oneOf.2.type","typeLabel":"string"},"link_preview":{"type":"object","properties":{"url":{"type":"string","description":"The URL of the link preview mention.","isRequired":true,"uniqueKey":"oneOf.1.title.items.[INDEX].oneOf.1.mention.oneOf.2.link_preview.url","typeLabel":"string"}},"additionalProperties":false,"required":["url"],"description":"Details of the link preview mention.","isRequired":true,"uniqueKey":"oneOf.1.title.items.[INDEX].oneOf.1.mention.oneOf.2.link_preview","typeLabel":"object"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"oneOf.1.title.items.[INDEX].oneOf.1.mention.oneOf.2","typeLabel":"Link Preview · object"},{"type":"object","title":"Link Mention","description":"Mention objects represent an inline mention of a database, date, link preview mention, page, template mention, or user. A mention is created in the Notion UI when a user types `@` followed by the name of the reference.","required":["type","link_mention"],"properties":{"type":{"type":"string","const":"link_mention","description":"Always `link_mention`","isRequired":true,"uniqueKey":"oneOf.1.title.items.[INDEX].oneOf.1.mention.oneOf.3.type","typeLabel":"string"},"link_mention":{"type":"object","properties":{"href":{"type":"string","description":"The href of the link mention.","isRequired":true,"uniqueKey":"oneOf.1.title.items.[INDEX].oneOf.1.mention.oneOf.3.link_mention.href","typeLabel":"string"},"title":{"type":"string","description":"The title of the link.","uniqueKey":"oneOf.1.title.items.[INDEX].oneOf.1.mention.oneOf.3.link_mention.title","typeLabel":"string"},"description":{"type":"string","description":"The description of the link.","uniqueKey":"oneOf.1.title.items.[INDEX].oneOf.1.mention.oneOf.3.link_mention.description","typeLabel":"string"},"link_author":{"type":"string","description":"The author of the link.","uniqueKey":"oneOf.1.title.items.[INDEX].oneOf.1.mention.oneOf.3.link_mention.link_author","typeLabel":"string"},"link_provider":{"type":"string","description":"The provider of the link.","uniqueKey":"oneOf.1.title.items.[INDEX].oneOf.1.mention.oneOf.3.link_mention.link_provider","typeLabel":"string"},"thumbnail_url":{"type":"string","description":"The thumbnail URL of the link.","uniqueKey":"oneOf.1.title.items.[INDEX].oneOf.1.mention.oneOf.3.link_mention.thumbnail_url","typeLabel":"string"},"icon_url":{"type":"string","description":"The icon URL of the link.","uniqueKey":"oneOf.1.title.items.[INDEX].oneOf.1.mention.oneOf.3.link_mention.icon_url","typeLabel":"string"},"iframe_url":{"type":"string","description":"The iframe URL of the link.","uniqueKey":"oneOf.1.title.items.[INDEX].oneOf.1.mention.oneOf.3.link_mention.iframe_url","typeLabel":"string"},"height":{"type":"integer","description":"The height of the link preview iframe.","uniqueKey":"oneOf.1.title.items.[INDEX].oneOf.1.mention.oneOf.3.link_mention.height","typeLabel":"integer"},"padding":{"type":"integer","description":"The padding of the link preview iframe.","uniqueKey":"oneOf.1.title.items.[INDEX].oneOf.1.mention.oneOf.3.link_mention.padding","typeLabel":"integer"},"padding_top":{"type":"integer","description":"The top padding of the link preview iframe.","uniqueKey":"oneOf.1.title.items.[INDEX].oneOf.1.mention.oneOf.3.link_mention.padding_top","typeLabel":"integer"}},"additionalProperties":false,"required":["href"],"description":"Details of the link mention.","isRequired":true,"uniqueKey":"oneOf.1.title.items.[INDEX].oneOf.1.mention.oneOf.3.link_mention","typeLabel":"object"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"oneOf.1.title.items.[INDEX].oneOf.1.mention.oneOf.3","typeLabel":"Link Mention · object"},{"type":"object","title":"Page","description":"Mention objects represent an inline mention of a database, date, link preview mention, page, template mention, or user. A mention is created in the Notion UI when a user types `@` followed by the name of the reference.","required":["type","page"],"properties":{"type":{"type":"string","const":"page","description":"Always `page`","isRequired":true,"uniqueKey":"oneOf.1.title.items.[INDEX].oneOf.1.mention.oneOf.4.type","typeLabel":"string"},"page":{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"The ID of the page in the mention.","isRequired":true,"uniqueKey":"oneOf.1.title.items.[INDEX].oneOf.1.mention.oneOf.4.page.id","typeLabel":"string\u003cuuid>"}},"additionalProperties":false,"required":["id"],"description":"Details of the page mention.","isRequired":true,"uniqueKey":"oneOf.1.title.items.[INDEX].oneOf.1.mention.oneOf.4.page","typeLabel":"object"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"oneOf.1.title.items.[INDEX].oneOf.1.mention.oneOf.4","typeLabel":"Page · object"},{"type":"object","title":"Database","description":"Mention objects represent an inline mention of a database, date, link preview mention, page, template mention, or user. A mention is created in the Notion UI when a user types `@` followed by the name of the reference.","required":["type","database"],"properties":{"type":{"type":"string","const":"database","description":"Always `database`","isRequired":true,"uniqueKey":"oneOf.1.title.items.[INDEX].oneOf.1.mention.oneOf.5.type","typeLabel":"string"},"database":{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"The ID of the database in the mention.","isRequired":true,"uniqueKey":"oneOf.1.title.items.[INDEX].oneOf.1.mention.oneOf.5.database.id","typeLabel":"string\u003cuuid>"}},"additionalProperties":false,"required":["id"],"description":"Details of the database mention.","isRequired":true,"uniqueKey":"oneOf.1.title.items.[INDEX].oneOf.1.mention.oneOf.5.database","typeLabel":"object"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"oneOf.1.title.items.[INDEX].oneOf.1.mention.oneOf.5","typeLabel":"Database · object"},{"type":"object","title":"Template Mention","description":"Mention objects represent an inline mention of a database, date, link preview mention, page, template mention, or user. A mention is created in the Notion UI when a user types `@` followed by the name of the reference.","required":["type","template_mention"],"properties":{"type":{"type":"string","const":"template_mention","description":"Always `template_mention`","isRequired":true,"uniqueKey":"oneOf.1.title.items.[INDEX].oneOf.1.mention.oneOf.6.type","typeLabel":"string"},"template_mention":{"oneOf":[{"type":"object","title":"Template Mention Date","description":"Details of the template mention.","required":["type","template_mention_date"],"properties":{"type":{"type":"string","const":"template_mention_date","description":"Always `template_mention_date`","isRequired":true,"uniqueKey":"oneOf.1.title.items.[INDEX].oneOf.1.mention.oneOf.6.template_mention.oneOf.0.type","typeLabel":"string"},"template_mention_date":{"type":"string","enum":["today","now"],"description":"The date of the template mention.","isRequired":true,"uniqueKey":"oneOf.1.title.items.[INDEX].oneOf.1.mention.oneOf.6.template_mention.oneOf.0.template_mention_date","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"oneOf.1.title.items.[INDEX].oneOf.1.mention.oneOf.6.template_mention.oneOf.0","typeLabel":"Template Mention Date · object"},{"type":"object","title":"Template Mention User","description":"Details of the template mention.","required":["type","template_mention_user"],"properties":{"type":{"type":"string","const":"template_mention_user","description":"Always `template_mention_user`","isRequired":true,"uniqueKey":"oneOf.1.title.items.[INDEX].oneOf.1.mention.oneOf.6.template_mention.oneOf.1.type","typeLabel":"string"},"template_mention_user":{"type":"string","const":"me","description":"The user of the template mention.","isRequired":true,"uniqueKey":"oneOf.1.title.items.[INDEX].oneOf.1.mention.oneOf.6.template_mention.oneOf.1.template_mention_user","typeLabel":"string"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"oneOf.1.title.items.[INDEX].oneOf.1.mention.oneOf.6.template_mention.oneOf.1","typeLabel":"Template Mention User · object"}],"isRequired":true,"uniqueKey":"oneOf.1.title.items.[INDEX].oneOf.1.mention.oneOf.6.template_mention","typeLabel":"Template Mention Date · object | Template Mention User · object"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"oneOf.1.title.items.[INDEX].oneOf.1.mention.oneOf.6","typeLabel":"Template Mention · object"},{"type":"object","title":"Custom Emoji","description":"Mention objects represent an inline mention of a database, date, link preview mention, page, template mention, or user. A mention is created in the Notion UI when a user types `@` followed by the name of the reference.","required":["type","custom_emoji"],"properties":{"type":{"type":"string","const":"custom_emoji","description":"Always `custom_emoji`","isRequired":true,"uniqueKey":"oneOf.1.title.items.[INDEX].oneOf.1.mention.oneOf.7.type","typeLabel":"string"},"custom_emoji":{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"The ID of the custom emoji.","isRequired":true,"uniqueKey":"oneOf.1.title.items.[INDEX].oneOf.1.mention.oneOf.7.custom_emoji.id","typeLabel":"string\u003cuuid>"},"name":{"type":"string","description":"The name of the custom emoji.","isRequired":true,"uniqueKey":"oneOf.1.title.items.[INDEX].oneOf.1.mention.oneOf.7.custom_emoji.name","typeLabel":"string"},"url":{"type":"string","description":"The URL of the custom emoji.","isRequired":true,"uniqueKey":"oneOf.1.title.items.[INDEX].oneOf.1.mention.oneOf.7.custom_emoji.url","typeLabel":"string"}},"additionalProperties":false,"required":["id","name","url"],"description":"Details of the custom emoji mention.","isRequired":true,"uniqueKey":"oneOf.1.title.items.[INDEX].oneOf.1.mention.oneOf.7.custom_emoji","typeLabel":"object"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"oneOf.1.title.items.[INDEX].oneOf.1.mention.oneOf.7","typeLabel":"Custom Emoji · object"}],"isRequired":true,"uniqueKey":"oneOf.1.title.items.[INDEX].oneOf.1.mention","typeLabel":"User · object | Date · object | Link Preview · object | Link Mention · object | Page · object | Database · object | Template Mention · object | Custom Emoji · object"}},"additionalProperties":false,"uniqueKey":"oneOf.1.title.items.[INDEX].oneOf.1","typeLabel":"Mention · object"},{"type":"object","title":"Equation","required":["type","equation","plain_text","href","annotations"],"properties":{"plain_text":{"type":"string","description":"The plain text content of the rich text object, without any styling.","isRequired":true,"uniqueKey":"oneOf.1.title.items.[INDEX].oneOf.2.plain_text","typeLabel":"string"},"href":{"oneOf":[{"type":"string","description":"A URL that the rich text object links to or mentions.","isRequired":true,"uniqueKey":"oneOf.1.title.items.[INDEX].oneOf.2.href.oneOf.0","typeLabel":"string"},{"type":"null","description":"A URL that the rich text object links to or mentions.","isRequired":true,"uniqueKey":"oneOf.1.title.items.[INDEX].oneOf.2.href.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"oneOf.1.title.items.[INDEX].oneOf.2.href","typeLabel":"string | null"},"annotations":{"type":"object","properties":{"bold":{"type":"boolean","isRequired":true,"uniqueKey":"oneOf.1.title.items.[INDEX].oneOf.2.annotations.bold","typeLabel":"boolean"},"italic":{"type":"boolean","isRequired":true,"uniqueKey":"oneOf.1.title.items.[INDEX].oneOf.2.annotations.italic","typeLabel":"boolean"},"strikethrough":{"type":"boolean","isRequired":true,"uniqueKey":"oneOf.1.title.items.[INDEX].oneOf.2.annotations.strikethrough","typeLabel":"boolean"},"underline":{"type":"boolean","isRequired":true,"uniqueKey":"oneOf.1.title.items.[INDEX].oneOf.2.annotations.underline","typeLabel":"boolean"},"code":{"type":"boolean","isRequired":true,"uniqueKey":"oneOf.1.title.items.[INDEX].oneOf.2.annotations.code","typeLabel":"boolean"},"color":{"type":"string","enum":["default","gray","brown","orange","yellow","green","blue","purple","pink","red","default_background","gray_background","brown_background","orange_background","yellow_background","green_background","blue_background","purple_background","pink_background","red_background"],"description":"One of: `default`, `gray`, `brown`, `orange`, `yellow`, `green`, `blue`, `purple`, `pink`, `red`, `default_background`, `gray_background`, `brown_background`, `orange_background`, `yellow_background`, `green_background`, `blue_background`, `purple_background`, `pink_background`, `red_background`","isRequired":true,"uniqueKey":"oneOf.1.title.items.[INDEX].oneOf.2.annotations.color","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"required":["bold","italic","strikethrough","underline","code","color"],"description":"All rich text objects contain an annotations object that sets the styling for the rich text.","isRequired":true,"uniqueKey":"oneOf.1.title.items.[INDEX].oneOf.2.annotations","typeLabel":"object"},"type":{"type":"string","const":"equation","description":"Always `equation`","isRequired":true,"uniqueKey":"oneOf.1.title.items.[INDEX].oneOf.2.type","typeLabel":"string"},"equation":{"type":"object","properties":{"expression":{"type":"string","examples":["e=mc^2"],"description":"A KaTeX compatible string.","isRequired":true,"uniqueKey":"oneOf.1.title.items.[INDEX].oneOf.2.equation.expression","typeLabel":"string"}},"additionalProperties":false,"required":["expression"],"description":"Notion supports inline LaTeX equations as rich text objects with a type value of `equation`.","isRequired":true,"uniqueKey":"oneOf.1.title.items.[INDEX].oneOf.2.equation","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"oneOf.1.title.items.[INDEX].oneOf.2","typeLabel":"Equation · object"}],"uniqueKey":"oneOf.1.title.items.[INDEX]","typeLabel":"Text · object | Mention · object | Equation · object"},"maxItems":100,"description":"The title of the database.","isRequired":true,"uniqueKey":"oneOf.1.title","typeLabel":"(Text · object | Mention · object | Equation · object)[]"},"description":{"type":"array","items":{"oneOf":[{"type":"object","title":"Text","required":["type","text","plain_text","href","annotations"],"properties":{"plain_text":{"type":"string","description":"The plain text content of the rich text object, without any styling.","isRequired":true,"uniqueKey":"oneOf.1.description.items.[INDEX].oneOf.0.plain_text","typeLabel":"string"},"href":{"oneOf":[{"type":"string","description":"A URL that the rich text object links to or mentions.","isRequired":true,"uniqueKey":"oneOf.1.description.items.[INDEX].oneOf.0.href.oneOf.0","typeLabel":"string"},{"type":"null","description":"A URL that the rich text object links to or mentions.","isRequired":true,"uniqueKey":"oneOf.1.description.items.[INDEX].oneOf.0.href.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"oneOf.1.description.items.[INDEX].oneOf.0.href","typeLabel":"string | null"},"annotations":{"type":"object","properties":{"bold":{"type":"boolean","isRequired":true,"uniqueKey":"oneOf.1.description.items.[INDEX].oneOf.0.annotations.bold","typeLabel":"boolean"},"italic":{"type":"boolean","isRequired":true,"uniqueKey":"oneOf.1.description.items.[INDEX].oneOf.0.annotations.italic","typeLabel":"boolean"},"strikethrough":{"type":"boolean","isRequired":true,"uniqueKey":"oneOf.1.description.items.[INDEX].oneOf.0.annotations.strikethrough","typeLabel":"boolean"},"underline":{"type":"boolean","isRequired":true,"uniqueKey":"oneOf.1.description.items.[INDEX].oneOf.0.annotations.underline","typeLabel":"boolean"},"code":{"type":"boolean","isRequired":true,"uniqueKey":"oneOf.1.description.items.[INDEX].oneOf.0.annotations.code","typeLabel":"boolean"},"color":{"type":"string","enum":["default","gray","brown","orange","yellow","green","blue","purple","pink","red","default_background","gray_background","brown_background","orange_background","yellow_background","green_background","blue_background","purple_background","pink_background","red_background"],"description":"One of: `default`, `gray`, `brown`, `orange`, `yellow`, `green`, `blue`, `purple`, `pink`, `red`, `default_background`, `gray_background`, `brown_background`, `orange_background`, `yellow_background`, `green_background`, `blue_background`, `purple_background`, `pink_background`, `red_background`","isRequired":true,"uniqueKey":"oneOf.1.description.items.[INDEX].oneOf.0.annotations.color","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"required":["bold","italic","strikethrough","underline","code","color"],"description":"All rich text objects contain an annotations object that sets the styling for the rich text.","isRequired":true,"uniqueKey":"oneOf.1.description.items.[INDEX].oneOf.0.annotations","typeLabel":"object"},"type":{"type":"string","const":"text","description":"Always `text`","isRequired":true,"uniqueKey":"oneOf.1.description.items.[INDEX].oneOf.0.type","typeLabel":"string"},"text":{"type":"object","properties":{"content":{"type":"string","maxLength":2000,"description":"The actual text content of the text.","isRequired":true,"uniqueKey":"oneOf.1.description.items.[INDEX].oneOf.0.text.content","typeLabel":"string"},"link":{"oneOf":[{"type":"object","description":"An object with information about any inline link in this text, if included.","required":["url"],"properties":{"url":{"type":"string","examples":["https://www.notion.com"],"description":"The URL of the link.","isRequired":true,"uniqueKey":"oneOf.1.description.items.[INDEX].oneOf.0.text.link.oneOf.0.url","typeLabel":"string"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"oneOf.1.description.items.[INDEX].oneOf.0.text.link.oneOf.0","typeLabel":"object"},{"type":"null","description":"An object with information about any inline link in this text, if included.","isRequired":true,"uniqueKey":"oneOf.1.description.items.[INDEX].oneOf.0.text.link.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"oneOf.1.description.items.[INDEX].oneOf.0.text.link","typeLabel":"object | null"}},"additionalProperties":false,"required":["content","link"],"description":"If a rich text object's type value is `text`, then the corresponding text field contains an object including the text content and any inline link.","isRequired":true,"uniqueKey":"oneOf.1.description.items.[INDEX].oneOf.0.text","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"oneOf.1.description.items.[INDEX].oneOf.0","typeLabel":"Text · object"},{"type":"object","title":"Mention","required":["type","mention","plain_text","href","annotations"],"properties":{"plain_text":{"type":"string","description":"The plain text content of the rich text object, without any styling.","isRequired":true,"uniqueKey":"oneOf.1.description.items.[INDEX].oneOf.1.plain_text","typeLabel":"string"},"href":{"oneOf":[{"type":"string","description":"A URL that the rich text object links to or mentions.","isRequired":true,"uniqueKey":"oneOf.1.description.items.[INDEX].oneOf.1.href.oneOf.0","typeLabel":"string"},{"type":"null","description":"A URL that the rich text object links to or mentions.","isRequired":true,"uniqueKey":"oneOf.1.description.items.[INDEX].oneOf.1.href.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"oneOf.1.description.items.[INDEX].oneOf.1.href","typeLabel":"string | null"},"annotations":{"type":"object","properties":{"bold":{"type":"boolean","isRequired":true,"uniqueKey":"oneOf.1.description.items.[INDEX].oneOf.1.annotations.bold","typeLabel":"boolean"},"italic":{"type":"boolean","isRequired":true,"uniqueKey":"oneOf.1.description.items.[INDEX].oneOf.1.annotations.italic","typeLabel":"boolean"},"strikethrough":{"type":"boolean","isRequired":true,"uniqueKey":"oneOf.1.description.items.[INDEX].oneOf.1.annotations.strikethrough","typeLabel":"boolean"},"underline":{"type":"boolean","isRequired":true,"uniqueKey":"oneOf.1.description.items.[INDEX].oneOf.1.annotations.underline","typeLabel":"boolean"},"code":{"type":"boolean","isRequired":true,"uniqueKey":"oneOf.1.description.items.[INDEX].oneOf.1.annotations.code","typeLabel":"boolean"},"color":{"type":"string","enum":["default","gray","brown","orange","yellow","green","blue","purple","pink","red","default_background","gray_background","brown_background","orange_background","yellow_background","green_background","blue_background","purple_background","pink_background","red_background"],"description":"One of: `default`, `gray`, `brown`, `orange`, `yellow`, `green`, `blue`, `purple`, `pink`, `red`, `default_background`, `gray_background`, `brown_background`, `orange_background`, `yellow_background`, `green_background`, `blue_background`, `purple_background`, `pink_background`, `red_background`","isRequired":true,"uniqueKey":"oneOf.1.description.items.[INDEX].oneOf.1.annotations.color","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"required":["bold","italic","strikethrough","underline","code","color"],"description":"All rich text objects contain an annotations object that sets the styling for the rich text.","isRequired":true,"uniqueKey":"oneOf.1.description.items.[INDEX].oneOf.1.annotations","typeLabel":"object"},"type":{"type":"string","const":"mention","description":"Always `mention`","isRequired":true,"uniqueKey":"oneOf.1.description.items.[INDEX].oneOf.1.type","typeLabel":"string"},"mention":{"oneOf":[{"type":"object","title":"User","description":"Mention objects represent an inline mention of a database, date, link preview mention, page, template mention, or user. A mention is created in the Notion UI when a user types `@` followed by the name of the reference.","required":["type","user"],"properties":{"type":{"type":"string","const":"user","description":"Always `user`","isRequired":true,"uniqueKey":"oneOf.1.description.items.[INDEX].oneOf.1.mention.oneOf.0.type","typeLabel":"string"},"user":{"oneOf":[{"type":"object","description":"Details of the user mention.","required":["id","object"],"properties":{"id":{"type":"string","format":"uuid","isRequired":true,"uniqueKey":"oneOf.1.description.items.[INDEX].oneOf.1.mention.oneOf.0.user.oneOf.0.id","typeLabel":"string\u003cuuid>"},"object":{"type":"string","const":"user","description":"Always `user`","isRequired":true,"uniqueKey":"oneOf.1.description.items.[INDEX].oneOf.1.mention.oneOf.0.user.oneOf.0.object","typeLabel":"string"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"oneOf.1.description.items.[INDEX].oneOf.1.mention.oneOf.0.user.oneOf.0","typeLabel":"object"},{"type":"object","title":"Person","description":"Details of the user mention.","required":["type","person","id","object","name","avatar_url"],"properties":{"id":{"type":"string","format":"uuid","description":"The ID of the user.","isRequired":true,"uniqueKey":"oneOf.1.description.items.[INDEX].oneOf.1.mention.oneOf.0.user.oneOf.1.id","typeLabel":"string\u003cuuid>"},"object":{"type":"string","const":"user","description":"The user object type name.","isRequired":true,"uniqueKey":"oneOf.1.description.items.[INDEX].oneOf.1.mention.oneOf.0.user.oneOf.1.object","typeLabel":"string"},"name":{"oneOf":[{"type":"string","description":"The name of the user.","isRequired":true,"uniqueKey":"oneOf.1.description.items.[INDEX].oneOf.1.mention.oneOf.0.user.oneOf.1.name.oneOf.0","typeLabel":"string"},{"type":"null","description":"The name of the user.","isRequired":true,"uniqueKey":"oneOf.1.description.items.[INDEX].oneOf.1.mention.oneOf.0.user.oneOf.1.name.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"oneOf.1.description.items.[INDEX].oneOf.1.mention.oneOf.0.user.oneOf.1.name","typeLabel":"string | null"},"avatar_url":{"oneOf":[{"type":"string","description":"The avatar URL of the user.","isRequired":true,"uniqueKey":"oneOf.1.description.items.[INDEX].oneOf.1.mention.oneOf.0.user.oneOf.1.avatar_url.oneOf.0","typeLabel":"string"},{"type":"null","description":"The avatar URL of the user.","isRequired":true,"uniqueKey":"oneOf.1.description.items.[INDEX].oneOf.1.mention.oneOf.0.user.oneOf.1.avatar_url.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"oneOf.1.description.items.[INDEX].oneOf.1.mention.oneOf.0.user.oneOf.1.avatar_url","typeLabel":"string | null"},"type":{"type":"string","const":"person","description":"Indicates this user is a person.","isRequired":true,"uniqueKey":"oneOf.1.description.items.[INDEX].oneOf.1.mention.oneOf.0.user.oneOf.1.type","typeLabel":"string"},"person":{"type":"object","properties":{"email":{"type":"string","description":"The email of the person.","uniqueKey":"oneOf.1.description.items.[INDEX].oneOf.1.mention.oneOf.0.user.oneOf.1.person.email","typeLabel":"string"},"email_verified":{"type":"boolean","description":"Whether the person's email is verified.","uniqueKey":"oneOf.1.description.items.[INDEX].oneOf.1.mention.oneOf.0.user.oneOf.1.person.email_verified","typeLabel":"boolean"}},"additionalProperties":false,"description":"Details about the person, when the `type` of the user is `person`.","isRequired":true,"uniqueKey":"oneOf.1.description.items.[INDEX].oneOf.1.mention.oneOf.0.user.oneOf.1.person","typeLabel":"object"},"agent_id":{"type":"string","format":"uuid","description":"The ID of the Custom Agent this bot acts for. Only present when the user is a Custom Agent's bot.","uniqueKey":"oneOf.1.description.items.[INDEX].oneOf.1.mention.oneOf.0.user.oneOf.1.agent_id","typeLabel":"string\u003cuuid>"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"oneOf.1.description.items.[INDEX].oneOf.1.mention.oneOf.0.user.oneOf.1","typeLabel":"Person · object"},{"type":"object","title":"Bot","description":"Details of the user mention.","required":["type","bot","id","object","name","avatar_url"],"properties":{"id":{"type":"string","format":"uuid","description":"The ID of the user.","isRequired":true,"uniqueKey":"oneOf.1.description.items.[INDEX].oneOf.1.mention.oneOf.0.user.oneOf.2.id","typeLabel":"string\u003cuuid>"},"object":{"type":"string","const":"user","description":"The user object type name.","isRequired":true,"uniqueKey":"oneOf.1.description.items.[INDEX].oneOf.1.mention.oneOf.0.user.oneOf.2.object","typeLabel":"string"},"name":{"oneOf":[{"type":"string","description":"The name of the user.","isRequired":true,"uniqueKey":"oneOf.1.description.items.[INDEX].oneOf.1.mention.oneOf.0.user.oneOf.2.name.oneOf.0","typeLabel":"string"},{"type":"null","description":"The name of the user.","isRequired":true,"uniqueKey":"oneOf.1.description.items.[INDEX].oneOf.1.mention.oneOf.0.user.oneOf.2.name.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"oneOf.1.description.items.[INDEX].oneOf.1.mention.oneOf.0.user.oneOf.2.name","typeLabel":"string | null"},"avatar_url":{"oneOf":[{"type":"string","description":"The avatar URL of the user.","isRequired":true,"uniqueKey":"oneOf.1.description.items.[INDEX].oneOf.1.mention.oneOf.0.user.oneOf.2.avatar_url.oneOf.0","typeLabel":"string"},{"type":"null","description":"The avatar URL of the user.","isRequired":true,"uniqueKey":"oneOf.1.description.items.[INDEX].oneOf.1.mention.oneOf.0.user.oneOf.2.avatar_url.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"oneOf.1.description.items.[INDEX].oneOf.1.mention.oneOf.0.user.oneOf.2.avatar_url","typeLabel":"string | null"},"type":{"type":"string","const":"bot","description":"Indicates this user is a bot.","isRequired":true,"uniqueKey":"oneOf.1.description.items.[INDEX].oneOf.1.mention.oneOf.0.user.oneOf.2.type","typeLabel":"string"},"bot":{"oneOf":[{"type":"object","description":"Details about the bot, when the `type` of the user is `bot`.","properties":{},"additionalProperties":false,"isRequired":true,"uniqueKey":"oneOf.1.description.items.[INDEX].oneOf.1.mention.oneOf.0.user.oneOf.2.bot.oneOf.0","typeLabel":"object"},{"type":"object","description":"Details about the bot, when the `type` of the user is `bot`.","required":["owner","workspace_id","workspace_limits","workspace_name"],"properties":{"owner":{"type":"any","description":"Details about the owner of the bot.","isRequired":true,"uniqueKey":"oneOf.1.description.items.[INDEX].oneOf.1.mention.oneOf.0.user.oneOf.2.bot.oneOf.1.owner","typeLabel":"any"},"workspace_id":{"type":"string","description":"The ID of the bot's workspace.","isRequired":true,"uniqueKey":"oneOf.1.description.items.[INDEX].oneOf.1.mention.oneOf.0.user.oneOf.2.bot.oneOf.1.workspace_id","typeLabel":"string"},"workspace_limits":{"type":"object","properties":{"max_file_upload_size_in_bytes":{"type":"integer","minimum":0,"description":"The maximum allowable size of a file upload, in bytes","isRequired":true,"uniqueKey":"oneOf.1.description.items.[INDEX].oneOf.1.mention.oneOf.0.user.oneOf.2.bot.oneOf.1.workspace_limits.max_file_upload_size_in_bytes","typeLabel":"integer"}},"additionalProperties":false,"required":["max_file_upload_size_in_bytes"],"description":"Limits and restrictions that apply to the bot's workspace","isRequired":true,"uniqueKey":"oneOf.1.description.items.[INDEX].oneOf.1.mention.oneOf.0.user.oneOf.2.bot.oneOf.1.workspace_limits","typeLabel":"object"},"workspace_name":{"type":"any","description":"The name of the bot's workspace.","isRequired":true,"uniqueKey":"oneOf.1.description.items.[INDEX].oneOf.1.mention.oneOf.0.user.oneOf.2.bot.oneOf.1.workspace_name","typeLabel":"any"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"oneOf.1.description.items.[INDEX].oneOf.1.mention.oneOf.0.user.oneOf.2.bot.oneOf.1","typeLabel":"object"}],"isRequired":true,"uniqueKey":"oneOf.1.description.items.[INDEX].oneOf.1.mention.oneOf.0.user.oneOf.2.bot","typeLabel":"object"},"agent_id":{"type":"string","format":"uuid","description":"The ID of the Custom Agent this bot acts for. Only present when the user is a Custom Agent's bot.","uniqueKey":"oneOf.1.description.items.[INDEX].oneOf.1.mention.oneOf.0.user.oneOf.2.agent_id","typeLabel":"string\u003cuuid>"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"oneOf.1.description.items.[INDEX].oneOf.1.mention.oneOf.0.user.oneOf.2","typeLabel":"Bot · object"}],"isRequired":true,"uniqueKey":"oneOf.1.description.items.[INDEX].oneOf.1.mention.oneOf.0.user","typeLabel":"object | Person · object | Bot · object"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"oneOf.1.description.items.[INDEX].oneOf.1.mention.oneOf.0","typeLabel":"User · object"},{"type":"object","title":"Date","description":"Mention objects represent an inline mention of a database, date, link preview mention, page, template mention, or user. A mention is created in the Notion UI when a user types `@` followed by the name of the reference.","required":["type","date"],"properties":{"type":{"type":"string","const":"date","description":"Always `date`","isRequired":true,"uniqueKey":"oneOf.1.description.items.[INDEX].oneOf.1.mention.oneOf.1.type","typeLabel":"string"},"date":{"type":"object","properties":{"start":{"type":"string","format":"date","description":"The start date of the date object.","isRequired":true,"uniqueKey":"oneOf.1.description.items.[INDEX].oneOf.1.mention.oneOf.1.date.start","typeLabel":"string\u003cdate>"},"end":{"oneOf":[{"type":"string","description":"The end date of the date object, if any.","format":"date","isRequired":true,"uniqueKey":"oneOf.1.description.items.[INDEX].oneOf.1.mention.oneOf.1.date.end.oneOf.0","typeLabel":"string\u003cdate>"},{"type":"null","description":"The end date of the date object, if any.","isRequired":true,"uniqueKey":"oneOf.1.description.items.[INDEX].oneOf.1.mention.oneOf.1.date.end.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"oneOf.1.description.items.[INDEX].oneOf.1.mention.oneOf.1.date.end","typeLabel":"string\u003cdate> | null"},"time_zone":{"oneOf":[{"type":"string","description":"The time zone of the date object.","example":"Africa/Abidjan","isRequired":true,"uniqueKey":"oneOf.1.description.items.[INDEX].oneOf.1.mention.oneOf.1.date.time_zone.oneOf.0","typeLabel":"string"},{"type":"null","description":"The time zone of the date object.","isRequired":true,"uniqueKey":"oneOf.1.description.items.[INDEX].oneOf.1.mention.oneOf.1.date.time_zone.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"oneOf.1.description.items.[INDEX].oneOf.1.mention.oneOf.1.date.time_zone","typeLabel":"string | null"}},"additionalProperties":false,"required":["start","end","time_zone"],"description":"Details of the date mention.","isRequired":true,"uniqueKey":"oneOf.1.description.items.[INDEX].oneOf.1.mention.oneOf.1.date","typeLabel":"object"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"oneOf.1.description.items.[INDEX].oneOf.1.mention.oneOf.1","typeLabel":"Date · object"},{"type":"object","title":"Link Preview","description":"Mention objects represent an inline mention of a database, date, link preview mention, page, template mention, or user. A mention is created in the Notion UI when a user types `@` followed by the name of the reference.","required":["type","link_preview"],"properties":{"type":{"type":"string","const":"link_preview","description":"Always `link_preview`","isRequired":true,"uniqueKey":"oneOf.1.description.items.[INDEX].oneOf.1.mention.oneOf.2.type","typeLabel":"string"},"link_preview":{"type":"object","properties":{"url":{"type":"string","description":"The URL of the link preview mention.","isRequired":true,"uniqueKey":"oneOf.1.description.items.[INDEX].oneOf.1.mention.oneOf.2.link_preview.url","typeLabel":"string"}},"additionalProperties":false,"required":["url"],"description":"Details of the link preview mention.","isRequired":true,"uniqueKey":"oneOf.1.description.items.[INDEX].oneOf.1.mention.oneOf.2.link_preview","typeLabel":"object"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"oneOf.1.description.items.[INDEX].oneOf.1.mention.oneOf.2","typeLabel":"Link Preview · object"},{"type":"object","title":"Link Mention","description":"Mention objects represent an inline mention of a database, date, link preview mention, page, template mention, or user. A mention is created in the Notion UI when a user types `@` followed by the name of the reference.","required":["type","link_mention"],"properties":{"type":{"type":"string","const":"link_mention","description":"Always `link_mention`","isRequired":true,"uniqueKey":"oneOf.1.description.items.[INDEX].oneOf.1.mention.oneOf.3.type","typeLabel":"string"},"link_mention":{"type":"object","properties":{"href":{"type":"string","description":"The href of the link mention.","isRequired":true,"uniqueKey":"oneOf.1.description.items.[INDEX].oneOf.1.mention.oneOf.3.link_mention.href","typeLabel":"string"},"title":{"type":"string","description":"The title of the link.","uniqueKey":"oneOf.1.description.items.[INDEX].oneOf.1.mention.oneOf.3.link_mention.title","typeLabel":"string"},"description":{"type":"string","description":"The description of the link.","uniqueKey":"oneOf.1.description.items.[INDEX].oneOf.1.mention.oneOf.3.link_mention.description","typeLabel":"string"},"link_author":{"type":"string","description":"The author of the link.","uniqueKey":"oneOf.1.description.items.[INDEX].oneOf.1.mention.oneOf.3.link_mention.link_author","typeLabel":"string"},"link_provider":{"type":"string","description":"The provider of the link.","uniqueKey":"oneOf.1.description.items.[INDEX].oneOf.1.mention.oneOf.3.link_mention.link_provider","typeLabel":"string"},"thumbnail_url":{"type":"string","description":"The thumbnail URL of the link.","uniqueKey":"oneOf.1.description.items.[INDEX].oneOf.1.mention.oneOf.3.link_mention.thumbnail_url","typeLabel":"string"},"icon_url":{"type":"string","description":"The icon URL of the link.","uniqueKey":"oneOf.1.description.items.[INDEX].oneOf.1.mention.oneOf.3.link_mention.icon_url","typeLabel":"string"},"iframe_url":{"type":"string","description":"The iframe URL of the link.","uniqueKey":"oneOf.1.description.items.[INDEX].oneOf.1.mention.oneOf.3.link_mention.iframe_url","typeLabel":"string"},"height":{"type":"integer","description":"The height of the link preview iframe.","uniqueKey":"oneOf.1.description.items.[INDEX].oneOf.1.mention.oneOf.3.link_mention.height","typeLabel":"integer"},"padding":{"type":"integer","description":"The padding of the link preview iframe.","uniqueKey":"oneOf.1.description.items.[INDEX].oneOf.1.mention.oneOf.3.link_mention.padding","typeLabel":"integer"},"padding_top":{"type":"integer","description":"The top padding of the link preview iframe.","uniqueKey":"oneOf.1.description.items.[INDEX].oneOf.1.mention.oneOf.3.link_mention.padding_top","typeLabel":"integer"}},"additionalProperties":false,"required":["href"],"description":"Details of the link mention.","isRequired":true,"uniqueKey":"oneOf.1.description.items.[INDEX].oneOf.1.mention.oneOf.3.link_mention","typeLabel":"object"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"oneOf.1.description.items.[INDEX].oneOf.1.mention.oneOf.3","typeLabel":"Link Mention · object"},{"type":"object","title":"Page","description":"Mention objects represent an inline mention of a database, date, link preview mention, page, template mention, or user. A mention is created in the Notion UI when a user types `@` followed by the name of the reference.","required":["type","page"],"properties":{"type":{"type":"string","const":"page","description":"Always `page`","isRequired":true,"uniqueKey":"oneOf.1.description.items.[INDEX].oneOf.1.mention.oneOf.4.type","typeLabel":"string"},"page":{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"The ID of the page in the mention.","isRequired":true,"uniqueKey":"oneOf.1.description.items.[INDEX].oneOf.1.mention.oneOf.4.page.id","typeLabel":"string\u003cuuid>"}},"additionalProperties":false,"required":["id"],"description":"Details of the page mention.","isRequired":true,"uniqueKey":"oneOf.1.description.items.[INDEX].oneOf.1.mention.oneOf.4.page","typeLabel":"object"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"oneOf.1.description.items.[INDEX].oneOf.1.mention.oneOf.4","typeLabel":"Page · object"},{"type":"object","title":"Database","description":"Mention objects represent an inline mention of a database, date, link preview mention, page, template mention, or user. A mention is created in the Notion UI when a user types `@` followed by the name of the reference.","required":["type","database"],"properties":{"type":{"type":"string","const":"database","description":"Always `database`","isRequired":true,"uniqueKey":"oneOf.1.description.items.[INDEX].oneOf.1.mention.oneOf.5.type","typeLabel":"string"},"database":{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"The ID of the database in the mention.","isRequired":true,"uniqueKey":"oneOf.1.description.items.[INDEX].oneOf.1.mention.oneOf.5.database.id","typeLabel":"string\u003cuuid>"}},"additionalProperties":false,"required":["id"],"description":"Details of the database mention.","isRequired":true,"uniqueKey":"oneOf.1.description.items.[INDEX].oneOf.1.mention.oneOf.5.database","typeLabel":"object"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"oneOf.1.description.items.[INDEX].oneOf.1.mention.oneOf.5","typeLabel":"Database · object"},{"type":"object","title":"Template Mention","description":"Mention objects represent an inline mention of a database, date, link preview mention, page, template mention, or user. A mention is created in the Notion UI when a user types `@` followed by the name of the reference.","required":["type","template_mention"],"properties":{"type":{"type":"string","const":"template_mention","description":"Always `template_mention`","isRequired":true,"uniqueKey":"oneOf.1.description.items.[INDEX].oneOf.1.mention.oneOf.6.type","typeLabel":"string"},"template_mention":{"oneOf":[{"type":"object","title":"Template Mention Date","description":"Details of the template mention.","required":["type","template_mention_date"],"properties":{"type":{"type":"string","const":"template_mention_date","description":"Always `template_mention_date`","isRequired":true,"uniqueKey":"oneOf.1.description.items.[INDEX].oneOf.1.mention.oneOf.6.template_mention.oneOf.0.type","typeLabel":"string"},"template_mention_date":{"type":"string","enum":["today","now"],"description":"The date of the template mention.","isRequired":true,"uniqueKey":"oneOf.1.description.items.[INDEX].oneOf.1.mention.oneOf.6.template_mention.oneOf.0.template_mention_date","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"oneOf.1.description.items.[INDEX].oneOf.1.mention.oneOf.6.template_mention.oneOf.0","typeLabel":"Template Mention Date · object"},{"type":"object","title":"Template Mention User","description":"Details of the template mention.","required":["type","template_mention_user"],"properties":{"type":{"type":"string","const":"template_mention_user","description":"Always `template_mention_user`","isRequired":true,"uniqueKey":"oneOf.1.description.items.[INDEX].oneOf.1.mention.oneOf.6.template_mention.oneOf.1.type","typeLabel":"string"},"template_mention_user":{"type":"string","const":"me","description":"The user of the template mention.","isRequired":true,"uniqueKey":"oneOf.1.description.items.[INDEX].oneOf.1.mention.oneOf.6.template_mention.oneOf.1.template_mention_user","typeLabel":"string"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"oneOf.1.description.items.[INDEX].oneOf.1.mention.oneOf.6.template_mention.oneOf.1","typeLabel":"Template Mention User · object"}],"isRequired":true,"uniqueKey":"oneOf.1.description.items.[INDEX].oneOf.1.mention.oneOf.6.template_mention","typeLabel":"Template Mention Date · object | Template Mention User · object"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"oneOf.1.description.items.[INDEX].oneOf.1.mention.oneOf.6","typeLabel":"Template Mention · object"},{"type":"object","title":"Custom Emoji","description":"Mention objects represent an inline mention of a database, date, link preview mention, page, template mention, or user. A mention is created in the Notion UI when a user types `@` followed by the name of the reference.","required":["type","custom_emoji"],"properties":{"type":{"type":"string","const":"custom_emoji","description":"Always `custom_emoji`","isRequired":true,"uniqueKey":"oneOf.1.description.items.[INDEX].oneOf.1.mention.oneOf.7.type","typeLabel":"string"},"custom_emoji":{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"The ID of the custom emoji.","isRequired":true,"uniqueKey":"oneOf.1.description.items.[INDEX].oneOf.1.mention.oneOf.7.custom_emoji.id","typeLabel":"string\u003cuuid>"},"name":{"type":"string","description":"The name of the custom emoji.","isRequired":true,"uniqueKey":"oneOf.1.description.items.[INDEX].oneOf.1.mention.oneOf.7.custom_emoji.name","typeLabel":"string"},"url":{"type":"string","description":"The URL of the custom emoji.","isRequired":true,"uniqueKey":"oneOf.1.description.items.[INDEX].oneOf.1.mention.oneOf.7.custom_emoji.url","typeLabel":"string"}},"additionalProperties":false,"required":["id","name","url"],"description":"Details of the custom emoji mention.","isRequired":true,"uniqueKey":"oneOf.1.description.items.[INDEX].oneOf.1.mention.oneOf.7.custom_emoji","typeLabel":"object"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"oneOf.1.description.items.[INDEX].oneOf.1.mention.oneOf.7","typeLabel":"Custom Emoji · object"}],"isRequired":true,"uniqueKey":"oneOf.1.description.items.[INDEX].oneOf.1.mention","typeLabel":"User · object | Date · object | Link Preview · object | Link Mention · object | Page · object | Database · object | Template Mention · object | Custom Emoji · object"}},"additionalProperties":false,"uniqueKey":"oneOf.1.description.items.[INDEX].oneOf.1","typeLabel":"Mention · object"},{"type":"object","title":"Equation","required":["type","equation","plain_text","href","annotations"],"properties":{"plain_text":{"type":"string","description":"The plain text content of the rich text object, without any styling.","isRequired":true,"uniqueKey":"oneOf.1.description.items.[INDEX].oneOf.2.plain_text","typeLabel":"string"},"href":{"oneOf":[{"type":"string","description":"A URL that the rich text object links to or mentions.","isRequired":true,"uniqueKey":"oneOf.1.description.items.[INDEX].oneOf.2.href.oneOf.0","typeLabel":"string"},{"type":"null","description":"A URL that the rich text object links to or mentions.","isRequired":true,"uniqueKey":"oneOf.1.description.items.[INDEX].oneOf.2.href.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"oneOf.1.description.items.[INDEX].oneOf.2.href","typeLabel":"string | null"},"annotations":{"type":"object","properties":{"bold":{"type":"boolean","isRequired":true,"uniqueKey":"oneOf.1.description.items.[INDEX].oneOf.2.annotations.bold","typeLabel":"boolean"},"italic":{"type":"boolean","isRequired":true,"uniqueKey":"oneOf.1.description.items.[INDEX].oneOf.2.annotations.italic","typeLabel":"boolean"},"strikethrough":{"type":"boolean","isRequired":true,"uniqueKey":"oneOf.1.description.items.[INDEX].oneOf.2.annotations.strikethrough","typeLabel":"boolean"},"underline":{"type":"boolean","isRequired":true,"uniqueKey":"oneOf.1.description.items.[INDEX].oneOf.2.annotations.underline","typeLabel":"boolean"},"code":{"type":"boolean","isRequired":true,"uniqueKey":"oneOf.1.description.items.[INDEX].oneOf.2.annotations.code","typeLabel":"boolean"},"color":{"type":"string","enum":["default","gray","brown","orange","yellow","green","blue","purple","pink","red","default_background","gray_background","brown_background","orange_background","yellow_background","green_background","blue_background","purple_background","pink_background","red_background"],"description":"One of: `default`, `gray`, `brown`, `orange`, `yellow`, `green`, `blue`, `purple`, `pink`, `red`, `default_background`, `gray_background`, `brown_background`, `orange_background`, `yellow_background`, `green_background`, `blue_background`, `purple_background`, `pink_background`, `red_background`","isRequired":true,"uniqueKey":"oneOf.1.description.items.[INDEX].oneOf.2.annotations.color","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"required":["bold","italic","strikethrough","underline","code","color"],"description":"All rich text objects contain an annotations object that sets the styling for the rich text.","isRequired":true,"uniqueKey":"oneOf.1.description.items.[INDEX].oneOf.2.annotations","typeLabel":"object"},"type":{"type":"string","const":"equation","description":"Always `equation`","isRequired":true,"uniqueKey":"oneOf.1.description.items.[INDEX].oneOf.2.type","typeLabel":"string"},"equation":{"type":"object","properties":{"expression":{"type":"string","examples":["e=mc^2"],"description":"A KaTeX compatible string.","isRequired":true,"uniqueKey":"oneOf.1.description.items.[INDEX].oneOf.2.equation.expression","typeLabel":"string"}},"additionalProperties":false,"required":["expression"],"description":"Notion supports inline LaTeX equations as rich text objects with a type value of `equation`.","isRequired":true,"uniqueKey":"oneOf.1.description.items.[INDEX].oneOf.2.equation","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"oneOf.1.description.items.[INDEX].oneOf.2","typeLabel":"Equation · object"}],"uniqueKey":"oneOf.1.description.items.[INDEX]","typeLabel":"Text · object | Mention · object | Equation · object"},"maxItems":100,"description":"The description of the database.","isRequired":true,"uniqueKey":"oneOf.1.description","typeLabel":"(Text · object | Mention · object | Equation · object)[]"},"parent":{"oneOf":[{"type":"object","description":"The parent of the database. This is typically a page, block, or workspace, but can be another database in the case of wikis.","required":["type","page_id"],"properties":{"type":{"type":"string","const":"page_id","description":"The parent type.","isRequired":true,"uniqueKey":"oneOf.1.parent.oneOf.0.type","typeLabel":"string"},"page_id":{"type":"string","format":"uuid","description":"The ID of the parent page.","isRequired":true,"uniqueKey":"oneOf.1.parent.oneOf.0.page_id","typeLabel":"string\u003cuuid>"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"oneOf.1.parent.oneOf.0","typeLabel":"object"},{"type":"object","description":"The parent of the database. This is typically a page, block, or workspace, but can be another database in the case of wikis.","required":["type","workspace"],"properties":{"type":{"type":"string","const":"workspace","description":"The parent type.","isRequired":true,"uniqueKey":"oneOf.1.parent.oneOf.1.type","typeLabel":"string"},"workspace":{"type":"boolean","const":true,"description":"Always true for workspace parent.","isRequired":true,"uniqueKey":"oneOf.1.parent.oneOf.1.workspace","typeLabel":"boolean"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"oneOf.1.parent.oneOf.1","typeLabel":"object"},{"type":"object","description":"The parent of the database. This is typically a page, block, or workspace, but can be another database in the case of wikis.","required":["type","database_id"],"properties":{"type":{"type":"string","const":"database_id","description":"The parent type.","isRequired":true,"uniqueKey":"oneOf.1.parent.oneOf.2.type","typeLabel":"string"},"database_id":{"type":"string","format":"uuid","description":"The ID of the parent database.","isRequired":true,"uniqueKey":"oneOf.1.parent.oneOf.2.database_id","typeLabel":"string\u003cuuid>"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"oneOf.1.parent.oneOf.2","typeLabel":"object"},{"type":"object","description":"The parent of the database. This is typically a page, block, or workspace, but can be another database in the case of wikis.","required":["type","block_id"],"properties":{"type":{"type":"string","const":"block_id","description":"The parent type.","isRequired":true,"uniqueKey":"oneOf.1.parent.oneOf.3.type","typeLabel":"string"},"block_id":{"type":"string","format":"uuid","description":"The ID of the parent block.","isRequired":true,"uniqueKey":"oneOf.1.parent.oneOf.3.block_id","typeLabel":"string\u003cuuid>"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"oneOf.1.parent.oneOf.3","typeLabel":"object"}],"isRequired":true,"uniqueKey":"oneOf.1.parent","typeLabel":"object"},"is_inline":{"type":"boolean","description":"Whether the database is inline.","isRequired":true,"uniqueKey":"oneOf.1.is_inline","typeLabel":"boolean"},"database_type":{"oneOf":[{"type":"string","description":"The type of typed database, such as `tasks`, `projects`, or `skills`, or `null` for a regular database. Create a database accepts `tasks`, `projects`, and `skills`.","enum":["tasks","projects","sprints","docs","wiki","meetings","meeting_notes","skills","github_prs"],"isRequired":true,"uniqueKey":"oneOf.1.database_type.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","description":"The type of typed database, such as `tasks`, `projects`, or `skills`, or `null` for a regular database. Create a database accepts `tasks`, `projects`, and `skills`.","isRequired":true,"uniqueKey":"oneOf.1.database_type.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"oneOf.1.database_type","typeLabel":"enum\u003cstring> | null"},"in_trash":{"type":"boolean","description":"Whether the database is in the trash.","isRequired":true,"uniqueKey":"oneOf.1.in_trash","typeLabel":"boolean"},"is_locked":{"type":"boolean","description":"Whether the database is locked from editing in the Notion app UI.","isRequired":true,"uniqueKey":"oneOf.1.is_locked","typeLabel":"boolean"},"show_data_source_title":{"type":"boolean","description":"Whether the data source title is shown above the database's views, matching the Show data source title toggle in the Notion app. Full-page databases with one data source don't show this title even when this is `true`.","isRequired":true,"uniqueKey":"oneOf.1.show_data_source_title","typeLabel":"boolean"},"created_time":{"type":"string","format":"date-time","description":"The time when the database was created.","isRequired":true,"uniqueKey":"oneOf.1.created_time","typeLabel":"string\u003cdate-time>"},"last_edited_time":{"type":"string","format":"date-time","description":"The time when the database was last edited.","isRequired":true,"uniqueKey":"oneOf.1.last_edited_time","typeLabel":"string\u003cdate-time>"},"data_sources":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"The ID of the data source.","isRequired":true,"uniqueKey":"oneOf.1.data_sources.items.[INDEX].id","typeLabel":"string\u003cuuid>"},"name":{"type":"string","description":"The name of the data source.","isRequired":true,"uniqueKey":"oneOf.1.data_sources.items.[INDEX].name","typeLabel":"string"},"sync_metadata":{"type":"object","properties":{"health":{"oneOf":[{"type":"null","description":"Live collection sync health. Null means unavailable, not unhealthy. Missing timestamps are unknown.","uniqueKey":"oneOf.1.data_sources.items.[INDEX].sync_metadata.health.oneOf.0","typeLabel":"null"},{"type":"object","description":"Live collection sync health. Null means unavailable, not unhealthy. Missing timestamps are unknown.","required":["checks","error","ok","paused","stage"],"properties":{"checks":{"type":"object","properties":{"sync_version_updated_at":{"type":"string","isRequired":true,"uniqueKey":"oneOf.1.data_sources.items.[INDEX].sync_metadata.health.oneOf.1.checks.sync_version_updated_at","typeLabel":"string"},"delta_synced_through_at":{"type":"string","uniqueKey":"oneOf.1.data_sources.items.[INDEX].sync_metadata.health.oneOf.1.checks.delta_synced_through_at","typeLabel":"string"},"last_execution_succeeded_at":{"type":"string","uniqueKey":"oneOf.1.data_sources.items.[INDEX].sync_metadata.health.oneOf.1.checks.last_execution_succeeded_at","typeLabel":"string"}},"additionalProperties":false,"required":["sync_version_updated_at"],"isRequired":true,"uniqueKey":"oneOf.1.data_sources.items.[INDEX].sync_metadata.health.oneOf.1.checks","typeLabel":"object"},"error":{"type":"object","properties":{"code":{"type":"string","isRequired":true,"uniqueKey":"oneOf.1.data_sources.items.[INDEX].sync_metadata.health.oneOf.1.error.code","typeLabel":"string"},"severity":{"type":"string","enum":["action_required","degraded","failing"],"isRequired":true,"uniqueKey":"oneOf.1.data_sources.items.[INDEX].sync_metadata.health.oneOf.1.error.severity","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"required":["code","severity"],"isRequired":true,"uniqueKey":"oneOf.1.data_sources.items.[INDEX].sync_metadata.health.oneOf.1.error","typeLabel":"object"},"ok":{"type":"boolean","const":false,"isRequired":true,"uniqueKey":"oneOf.1.data_sources.items.[INDEX].sync_metadata.health.oneOf.1.ok","typeLabel":"boolean"},"paused":{"type":"boolean","isRequired":true,"uniqueKey":"oneOf.1.data_sources.items.[INDEX].sync_metadata.health.oneOf.1.paused","typeLabel":"boolean"},"stage":{"type":"string","enum":["backfilling","initializing","steady"],"isRequired":true,"uniqueKey":"oneOf.1.data_sources.items.[INDEX].sync_metadata.health.oneOf.1.stage","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"uniqueKey":"oneOf.1.data_sources.items.[INDEX].sync_metadata.health.oneOf.1","typeLabel":"object"},{"type":"object","description":"Live collection sync health. Null means unavailable, not unhealthy. Missing timestamps are unknown.","required":["checks","ok","paused","stage"],"properties":{"checks":{"type":"object","properties":{"sync_version_updated_at":{"type":"string","isRequired":true,"uniqueKey":"oneOf.1.data_sources.items.[INDEX].sync_metadata.health.oneOf.2.checks.sync_version_updated_at","typeLabel":"string"},"delta_synced_through_at":{"type":"string","uniqueKey":"oneOf.1.data_sources.items.[INDEX].sync_metadata.health.oneOf.2.checks.delta_synced_through_at","typeLabel":"string"},"last_execution_succeeded_at":{"type":"string","uniqueKey":"oneOf.1.data_sources.items.[INDEX].sync_metadata.health.oneOf.2.checks.last_execution_succeeded_at","typeLabel":"string"}},"additionalProperties":false,"required":["sync_version_updated_at"],"isRequired":true,"uniqueKey":"oneOf.1.data_sources.items.[INDEX].sync_metadata.health.oneOf.2.checks","typeLabel":"object"},"ok":{"type":"boolean","const":true,"isRequired":true,"uniqueKey":"oneOf.1.data_sources.items.[INDEX].sync_metadata.health.oneOf.2.ok","typeLabel":"boolean"},"paused":{"type":"boolean","isRequired":true,"uniqueKey":"oneOf.1.data_sources.items.[INDEX].sync_metadata.health.oneOf.2.paused","typeLabel":"boolean"},"stage":{"type":"string","enum":["backfilling","initializing","steady"],"isRequired":true,"uniqueKey":"oneOf.1.data_sources.items.[INDEX].sync_metadata.health.oneOf.2.stage","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"uniqueKey":"oneOf.1.data_sources.items.[INDEX].sync_metadata.health.oneOf.2","typeLabel":"object"},{"type":"object","description":"Live collection sync health. Null means unavailable, not unhealthy. Missing timestamps are unknown.","required":["paused"],"properties":{"paused":{"type":"boolean","const":true,"isRequired":true,"uniqueKey":"oneOf.1.data_sources.items.[INDEX].sync_metadata.health.oneOf.3.paused","typeLabel":"boolean"}},"additionalProperties":false,"uniqueKey":"oneOf.1.data_sources.items.[INDEX].sync_metadata.health.oneOf.3","typeLabel":"object"}],"uniqueKey":"oneOf.1.data_sources.items.[INDEX].sync_metadata.health","typeLabel":"null · object · object · object"},"owner_user_id":{"type":"string","format":"uuid","description":"Notion user who owns the sync credential, included when health is available.","uniqueKey":"oneOf.1.data_sources.items.[INDEX].sync_metadata.owner_user_id","typeLabel":"string\u003cuuid>"},"resource":{"type":"string","description":"Provider resource synced to this data source, when available.","uniqueKey":"oneOf.1.data_sources.items.[INDEX].sync_metadata.resource","typeLabel":"string"},"external_database_sync":{"type":"object","properties":{"sync_id":{"type":"string","format":"uuid","description":"The stored sync ID. This is not a credential.","isRequired":true,"uniqueKey":"oneOf.1.data_sources.items.[INDEX].sync_metadata.external_database_sync.sync_id","typeLabel":"string\u003cuuid>"},"provider":{"type":"string","enum":["github","jira","salesforce"],"description":"The sync provider: github (GitHub), jira (Jira), or salesforce (Salesforce).","isRequired":true,"uniqueKey":"oneOf.1.data_sources.items.[INDEX].sync_metadata.external_database_sync.provider","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"required":["sync_id","provider"],"description":"Stored identity of an external database sync.","uniqueKey":"oneOf.1.data_sources.items.[INDEX].sync_metadata.external_database_sync","typeLabel":"object"},"external_collection_type":{"type":"string","enum":["Jira","Salesforce"],"description":"The provider of a legacy synced data source: Jira or Salesforce. Values are case-sensitive.","uniqueKey":"oneOf.1.data_sources.items.[INDEX].sync_metadata.external_collection_type","typeLabel":"enum\u003cstring>"},"sync_id":{"type":"string","format":"uuid","description":"The stored sync ID when provider details are unavailable. This is not a credential.","uniqueKey":"oneOf.1.data_sources.items.[INDEX].sync_metadata.sync_id","typeLabel":"string\u003cuuid>"},"sync_state":{"type":"object","properties":{"syncing":{"oneOf":[{"type":"boolean","description":"Stored legacy sync state: true means syncing, false means not syncing, and row_limit_exceeded means the row limit stopped syncing. False does not guarantee a successful sync.","isRequired":true,"uniqueKey":"oneOf.1.data_sources.items.[INDEX].sync_metadata.sync_state.syncing.oneOf.0","typeLabel":"boolean"},{"type":"string","description":"Stored legacy sync state: true means syncing, false means not syncing, and row_limit_exceeded means the row limit stopped syncing. False does not guarantee a successful sync.","const":"row_limit_exceeded","isRequired":true,"uniqueKey":"oneOf.1.data_sources.items.[INDEX].sync_metadata.sync_state.syncing.oneOf.1","typeLabel":"string"}],"isRequired":true,"uniqueKey":"oneOf.1.data_sources.items.[INDEX].sync_metadata.sync_state.syncing","typeLabel":"boolean | string"},"last_synced_at":{"type":"string","format":"date-time","description":"Stored legacy sync update time in UTC ISO 8601 format. This does not guarantee that all source changes have been imported.","uniqueKey":"oneOf.1.data_sources.items.[INDEX].sync_metadata.sync_state.last_synced_at","typeLabel":"string\u003cdate-time>"},"last_sync_checkpoint_at":{"type":"string","format":"date-time","description":"Stored legacy sync checkpoint time in UTC ISO 8601 format.","uniqueKey":"oneOf.1.data_sources.items.[INDEX].sync_metadata.sync_state.last_sync_checkpoint_at","typeLabel":"string\u003cdate-time>"},"last_sync_heartbeat_at":{"type":"string","format":"date-time","description":"Stored legacy sync heartbeat time in UTC ISO 8601 format.","uniqueKey":"oneOf.1.data_sources.items.[INDEX].sync_metadata.sync_state.last_sync_heartbeat_at","typeLabel":"string\u003cdate-time>"}},"additionalProperties":false,"required":["syncing"],"description":"Stored state for a legacy synced data source. Missing or invalid timestamps are omitted. This is not a live health check.","uniqueKey":"oneOf.1.data_sources.items.[INDEX].sync_metadata.sync_state","typeLabel":"object"},"synced_collection_key":{"type":"string","description":"Opaque, developer-defined collection key for a worker sync. It is not a globally unique ID or a credential. Worker status is not included.","uniqueKey":"oneOf.1.data_sources.items.[INDEX].sync_metadata.synced_collection_key","typeLabel":"string"}},"additionalProperties":false,"description":"Sync identity and available health, included when retrieving a database.","uniqueKey":"oneOf.1.data_sources.items.[INDEX].sync_metadata","typeLabel":"object"}},"additionalProperties":false,"required":["id","name"],"uniqueKey":"oneOf.1.data_sources.items.[INDEX]","typeLabel":"object"},"maxItems":100,"description":"The data sources of the database.","isRequired":true,"uniqueKey":"oneOf.1.data_sources","typeLabel":"object[]"},"icon":{"oneOf":[{"type":"object","title":"Emoji","description":"The icon of the database.","required":["type","emoji"],"properties":{"type":{"type":"string","const":"emoji","description":"Type of icon. In this case, an emoji.","isRequired":true,"uniqueKey":"oneOf.1.icon.oneOf.0.type","typeLabel":"string"},"emoji":{"type":"string","example":"😀","description":"The emoji character used as the icon.","isRequired":true,"uniqueKey":"oneOf.1.icon.oneOf.0.emoji","typeLabel":"string"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"oneOf.1.icon.oneOf.0","typeLabel":"Emoji · object"},{"type":"object","title":"File","description":"The icon of the database.","required":["type","file"],"properties":{"type":{"type":"string","const":"file","description":"Type of icon. In this case, a file.","isRequired":true,"uniqueKey":"oneOf.1.icon.oneOf.1.type","typeLabel":"string"},"file":{"type":"object","properties":{"url":{"type":"string","description":"The URL of the file.","isRequired":true,"uniqueKey":"oneOf.1.icon.oneOf.1.file.url","typeLabel":"string"},"expiry_time":{"type":"string","format":"date-time","description":"The time when the URL will expire.","isRequired":true,"uniqueKey":"oneOf.1.icon.oneOf.1.file.expiry_time","typeLabel":"string\u003cdate-time>"}},"additionalProperties":false,"required":["url","expiry_time"],"description":"The file URL for the icon.","isRequired":true,"uniqueKey":"oneOf.1.icon.oneOf.1.file","typeLabel":"object"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"oneOf.1.icon.oneOf.1","typeLabel":"File · object"},{"type":"object","title":"External","description":"The icon of the database.","required":["type","external"],"properties":{"type":{"type":"string","const":"external","description":"Type of icon. In this case, an external URL.","isRequired":true,"uniqueKey":"oneOf.1.icon.oneOf.2.type","typeLabel":"string"},"external":{"type":"object","properties":{"url":{"type":"string","description":"The URL of the external file or resource.","isRequired":true,"uniqueKey":"oneOf.1.icon.oneOf.2.external.url","typeLabel":"string"}},"additionalProperties":false,"required":["url"],"description":"The external URL for the icon.","isRequired":true,"uniqueKey":"oneOf.1.icon.oneOf.2.external","typeLabel":"object"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"oneOf.1.icon.oneOf.2","typeLabel":"External · object"},{"type":"object","title":"Custom Emoji","description":"The icon of the database.","required":["type","custom_emoji"],"properties":{"type":{"type":"string","const":"custom_emoji","description":"Type of icon. In this case, a custom emoji.","isRequired":true,"uniqueKey":"oneOf.1.icon.oneOf.3.type","typeLabel":"string"},"custom_emoji":{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"The ID of the custom emoji.","isRequired":true,"uniqueKey":"oneOf.1.icon.oneOf.3.custom_emoji.id","typeLabel":"string\u003cuuid>"},"name":{"type":"string","description":"The name of the custom emoji.","isRequired":true,"uniqueKey":"oneOf.1.icon.oneOf.3.custom_emoji.name","typeLabel":"string"},"url":{"type":"string","description":"The URL of the custom emoji.","isRequired":true,"uniqueKey":"oneOf.1.icon.oneOf.3.custom_emoji.url","typeLabel":"string"}},"additionalProperties":false,"required":["id","name","url"],"description":"The custom emoji details for the icon.","isRequired":true,"uniqueKey":"oneOf.1.icon.oneOf.3.custom_emoji","typeLabel":"object"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"oneOf.1.icon.oneOf.3","typeLabel":"Custom Emoji · object"},{"type":"object","title":"Icon","description":"The icon of the database.","required":["type","icon"],"properties":{"type":{"type":"string","const":"icon","description":"Type of icon. In this case, a Notion native icon.","isRequired":true,"uniqueKey":"oneOf.1.icon.oneOf.4.type","typeLabel":"string"},"icon":{"type":"object","properties":{"name":{"type":"string","examples":["pizza","meeting","home","star","robot"],"description":"The name of the Notion icon (e.g. pizza, meeting, home). See the Notion icon picker for valid names.","isRequired":true,"uniqueKey":"oneOf.1.icon.oneOf.4.icon.name","typeLabel":"string"},"color":{"type":"string","enum":["gray","lightgray","brown","yellow","orange","green","blue","purple","pink","red"],"description":"The color variant of the icon. Valid values: gray, lightgray, brown, yellow, orange, green, blue, purple, pink, red.","isRequired":true,"uniqueKey":"oneOf.1.icon.oneOf.4.icon.color","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"required":["name","color"],"description":"The Notion native icon, specified by name and color.","isRequired":true,"uniqueKey":"oneOf.1.icon.oneOf.4.icon","typeLabel":"object"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"oneOf.1.icon.oneOf.4","typeLabel":"Icon · object"},{"type":"null","description":"The icon of the database.","isRequired":true,"uniqueKey":"oneOf.1.icon.oneOf.5","typeLabel":"null"}],"isRequired":true,"uniqueKey":"oneOf.1.icon","typeLabel":"Emoji · object | File · object | External · object | Custom Emoji · object | Icon · object | null"},"cover":{"oneOf":[{"type":"object","title":"File","description":"The cover of the database.","required":["type","file"],"properties":{"type":{"type":"string","const":"file","description":"Type of cover. In this case, a file.","isRequired":true,"uniqueKey":"oneOf.1.cover.oneOf.0.type","typeLabel":"string"},"file":{"type":"object","properties":{"url":{"type":"string","description":"The URL of the file.","isRequired":true,"uniqueKey":"oneOf.1.cover.oneOf.0.file.url","typeLabel":"string"},"expiry_time":{"type":"string","format":"date-time","description":"The time when the URL will expire.","isRequired":true,"uniqueKey":"oneOf.1.cover.oneOf.0.file.expiry_time","typeLabel":"string\u003cdate-time>"}},"additionalProperties":false,"required":["url","expiry_time"],"description":"The file URL for the cover.","isRequired":true,"uniqueKey":"oneOf.1.cover.oneOf.0.file","typeLabel":"object"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"oneOf.1.cover.oneOf.0","typeLabel":"File · object"},{"type":"object","title":"External","description":"The cover of the database.","required":["type","external"],"properties":{"type":{"type":"string","const":"external","description":"Type of cover. In this case, an external URL.","isRequired":true,"uniqueKey":"oneOf.1.cover.oneOf.1.type","typeLabel":"string"},"external":{"type":"object","properties":{"url":{"type":"string","description":"The URL of the external file or resource.","isRequired":true,"uniqueKey":"oneOf.1.cover.oneOf.1.external.url","typeLabel":"string"}},"additionalProperties":false,"required":["url"],"description":"The external URL for the cover.","isRequired":true,"uniqueKey":"oneOf.1.cover.oneOf.1.external","typeLabel":"object"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"oneOf.1.cover.oneOf.1","typeLabel":"External · object"},{"type":"null","description":"The cover of the database.","isRequired":true,"uniqueKey":"oneOf.1.cover.oneOf.2","typeLabel":"null"}],"isRequired":true,"uniqueKey":"oneOf.1.cover","typeLabel":"File · object | External · object | null"},"url":{"type":"string","description":"The URL of the database.","isRequired":true,"uniqueKey":"oneOf.1.url","typeLabel":"string"},"public_url":{"oneOf":[{"type":"string","description":"The public URL of the database if it is publicly accessible.","isRequired":true,"uniqueKey":"oneOf.1.public_url.oneOf.0","typeLabel":"string"},{"type":"null","description":"The public URL of the database if it is publicly accessible.","isRequired":true,"uniqueKey":"oneOf.1.public_url.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"oneOf.1.public_url","typeLabel":"string | null"}},"additionalProperties":false,"uniqueKey":"oneOf.1","typeLabel":"object"}],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"object":"database","id":"3c90c3cc-0d44-4b50-8888-8dd25736052a"}}},"exampleType":"generated"}},"exampleType":"generated"},"d771d840-541d-40d4-ae38-b383abda03cf":{"description":"","content":{"application/json":{"schema":{"type":"object","required":["code","status","object","message"],"properties":{"object":{"const":"error","isRequired":true,"uniqueKey":"object","typeLabel":"any"},"message":{"type":"string","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"code":{"enum":["invalid_json","invalid_request_url","invalid_request","missing_version","invalid_beta","validation_error","invalid_credit_limit"],"type":"string","isRequired":true,"uniqueKey":"code","typeLabel":"enum\u003cstring>"},"status":{"const":400,"isRequired":true,"uniqueKey":"status","typeLabel":"any"},"additional_data":{"type":"object","additionalProperties":{"oneOf":[{"type":"string","uniqueKey":"additional_data.additionalProperties.oneOf.0","typeLabel":"string"},{"type":"array","items":{"type":"string","uniqueKey":"additional_data.additionalProperties.oneOf.1.items.[INDEX]","typeLabel":"string"},"uniqueKey":"additional_data.additionalProperties.oneOf.1","typeLabel":"string[]"}],"uniqueKey":"additional_data.additionalProperties","typeLabel":"string | string[]"},"uniqueKey":"additional_data","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"object":"error","message":"\u003cstring>","code":"invalid_json","status":400,"additional_data":{}}}},"exampleType":"generated"}},"exampleType":"generated"},"51c96720-df4c-44e7-a21e-7a49508d2eae":{"description":"","content":{"application/json":{"schema":{"type":"object","required":["code","status","object","message"],"properties":{"object":{"const":"error","isRequired":true,"uniqueKey":"object","typeLabel":"any"},"message":{"type":"string","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"code":{"enum":["unauthorized"],"type":"string","isRequired":true,"uniqueKey":"code","typeLabel":"enum\u003cstring>"},"status":{"const":401,"isRequired":true,"uniqueKey":"status","typeLabel":"any"},"additional_data":{"type":"object","additionalProperties":{"oneOf":[{"type":"string","uniqueKey":"additional_data.additionalProperties.oneOf.0","typeLabel":"string"},{"type":"array","items":{"type":"string","uniqueKey":"additional_data.additionalProperties.oneOf.1.items.[INDEX]","typeLabel":"string"},"uniqueKey":"additional_data.additionalProperties.oneOf.1","typeLabel":"string[]"}],"uniqueKey":"additional_data.additionalProperties","typeLabel":"string | string[]"},"uniqueKey":"additional_data","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"object":"error","message":"\u003cstring>","code":"unauthorized","status":401,"additional_data":{}}}},"exampleType":"generated"}},"exampleType":"generated"},"51e0716a-85b5-44d3-9637-3729bd4f5457":{"description":"","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["code","status","object","message"],"properties":{"object":{"const":"error","isRequired":true,"uniqueKey":"oneOf.0.object","typeLabel":"any"},"message":{"type":"string","isRequired":true,"uniqueKey":"oneOf.0.message","typeLabel":"string"},"code":{"enum":["restricted_resource","status_change_not_allowed"],"type":"string","isRequired":true,"uniqueKey":"oneOf.0.code","typeLabel":"enum\u003cstring>"},"status":{"const":403,"isRequired":true,"uniqueKey":"oneOf.0.status","typeLabel":"any"},"additional_data":{"type":"object","additionalProperties":{"oneOf":[{"type":"string","uniqueKey":"oneOf.0.additional_data.additionalProperties.oneOf.0","typeLabel":"string"},{"type":"array","items":{"type":"string","uniqueKey":"oneOf.0.additional_data.additionalProperties.oneOf.1.items.[INDEX]","typeLabel":"string"},"uniqueKey":"oneOf.0.additional_data.additionalProperties.oneOf.1","typeLabel":"string[]"}],"uniqueKey":"oneOf.0.additional_data.additionalProperties","typeLabel":"string | string[]"},"uniqueKey":"oneOf.0.additional_data","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"oneOf.0","typeLabel":"object"},{"type":"object","required":["code","status","additional_data","object","message"],"properties":{"object":{"const":"error","isRequired":true,"uniqueKey":"oneOf.1.object","typeLabel":"any"},"message":{"type":"string","isRequired":true,"uniqueKey":"oneOf.1.message","typeLabel":"string"},"additional_data":{"type":"object","required":["tool_error_code","tool_error_class","tool_error_retryable","recovery_kind"],"properties":{"tool_error_code":{"const":"workspace_credits_exhausted","isRequired":true,"uniqueKey":"oneOf.1.additional_data.tool_error_code","typeLabel":"any"},"tool_error_class":{"const":"entitlement_required","isRequired":true,"uniqueKey":"oneOf.1.additional_data.tool_error_class","typeLabel":"any"},"tool_error_retryable":{"const":"false","isRequired":true,"uniqueKey":"oneOf.1.additional_data.tool_error_retryable","typeLabel":"any"},"recovery_kind":{"enum":["contact_workspace_owner","open_workspace_credit_settings"],"description":"The recovery action selected by Notion for the caller.","type":"string","isRequired":true,"uniqueKey":"oneOf.1.additional_data.recovery_kind","typeLabel":"enum\u003cstring>"},"recovery_url":{"type":"string","format":"uri","description":"Present when recovery_kind directs the caller to a settings page.","uniqueKey":"oneOf.1.additional_data.recovery_url","typeLabel":"string\u003curi>"}},"additionalProperties":{"oneOf":[{"type":"string","uniqueKey":"oneOf.1.additional_data.additionalProperties.oneOf.0","typeLabel":"string"},{"type":"array","items":{"type":"string","uniqueKey":"oneOf.1.additional_data.additionalProperties.oneOf.1.items.[INDEX]","typeLabel":"string"},"uniqueKey":"oneOf.1.additional_data.additionalProperties.oneOf.1","typeLabel":"string[]"}],"uniqueKey":"oneOf.1.additional_data.additionalProperties","typeLabel":"string | string[]"},"isRequired":true,"uniqueKey":"oneOf.1.additional_data","typeLabel":"object"},"code":{"const":"workspace_credits_exhausted","isRequired":true,"uniqueKey":"oneOf.1.code","typeLabel":"any"},"status":{"const":403,"isRequired":true,"uniqueKey":"oneOf.1.status","typeLabel":"any"}},"uniqueKey":"oneOf.1","typeLabel":"object"},{"type":"object","required":["code","status","additional_data","object","message"],"properties":{"object":{"const":"error","isRequired":true,"uniqueKey":"oneOf.2.object","typeLabel":"any"},"message":{"type":"string","isRequired":true,"uniqueKey":"oneOf.2.message","typeLabel":"string"},"additional_data":{"type":"object","required":["tool_error_code","tool_error_class","tool_error_retryable","recovery_kind"],"properties":{"tool_error_code":{"const":"agent_credit_limit_reached","isRequired":true,"uniqueKey":"oneOf.2.additional_data.tool_error_code","typeLabel":"any"},"tool_error_class":{"const":"entitlement_required","isRequired":true,"uniqueKey":"oneOf.2.additional_data.tool_error_class","typeLabel":"any"},"tool_error_retryable":{"const":"false","isRequired":true,"uniqueKey":"oneOf.2.additional_data.tool_error_retryable","typeLabel":"any"},"recovery_kind":{"enum":["contact_workspace_owner","none","open_agent_settings","request_agent_limit_increase","request_pending"],"description":"The recovery action selected by Notion for the caller.","type":"string","isRequired":true,"uniqueKey":"oneOf.2.additional_data.recovery_kind","typeLabel":"enum\u003cstring>"},"recovery_url":{"type":"string","format":"uri","description":"Present when recovery_kind directs the caller to a settings page.","uniqueKey":"oneOf.2.additional_data.recovery_url","typeLabel":"string\u003curi>"}},"additionalProperties":{"oneOf":[{"type":"string","uniqueKey":"oneOf.2.additional_data.additionalProperties.oneOf.0","typeLabel":"string"},{"type":"array","items":{"type":"string","uniqueKey":"oneOf.2.additional_data.additionalProperties.oneOf.1.items.[INDEX]","typeLabel":"string"},"uniqueKey":"oneOf.2.additional_data.additionalProperties.oneOf.1","typeLabel":"string[]"}],"uniqueKey":"oneOf.2.additional_data.additionalProperties","typeLabel":"string | string[]"},"isRequired":true,"uniqueKey":"oneOf.2.additional_data","typeLabel":"object"},"code":{"const":"agent_credit_limit_reached","isRequired":true,"uniqueKey":"oneOf.2.code","typeLabel":"any"},"status":{"const":403,"isRequired":true,"uniqueKey":"oneOf.2.status","typeLabel":"any"}},"uniqueKey":"oneOf.2","typeLabel":"object"}],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"object":"error","message":"\u003cstring>","code":"restricted_resource","status":403,"additional_data":{}}}},"exampleType":"generated"}},"exampleType":"generated"},"c5f4d3f4-252b-42b1-8be4-8bec46621962":{"description":"","content":{"application/json":{"schema":{"type":"object","required":["code","status","object","message"],"properties":{"object":{"const":"error","isRequired":true,"uniqueKey":"object","typeLabel":"any"},"message":{"type":"string","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"code":{"enum":["object_not_found","directory_not_found"],"type":"string","isRequired":true,"uniqueKey":"code","typeLabel":"enum\u003cstring>"},"status":{"const":404,"isRequired":true,"uniqueKey":"status","typeLabel":"any"},"additional_data":{"type":"object","additionalProperties":{"oneOf":[{"type":"string","uniqueKey":"additional_data.additionalProperties.oneOf.0","typeLabel":"string"},{"type":"array","items":{"type":"string","uniqueKey":"additional_data.additionalProperties.oneOf.1.items.[INDEX]","typeLabel":"string"},"uniqueKey":"additional_data.additionalProperties.oneOf.1","typeLabel":"string[]"}],"uniqueKey":"additional_data.additionalProperties","typeLabel":"string | string[]"},"uniqueKey":"additional_data","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"object":"error","message":"\u003cstring>","code":"object_not_found","status":404,"additional_data":{}}}},"exampleType":"generated"}},"exampleType":"generated"},"6c741e32-36c1-4923-826b-2f287a81a3e7":{"description":"","content":{"application/json":{"schema":{"type":"object","required":["code","status","object","message"],"properties":{"object":{"const":"error","isRequired":true,"uniqueKey":"object","typeLabel":"any"},"message":{"type":"string","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"code":{"enum":["row_limit_exceeded"],"type":"string","isRequired":true,"uniqueKey":"code","typeLabel":"enum\u003cstring>"},"status":{"const":406,"isRequired":true,"uniqueKey":"status","typeLabel":"any"},"additional_data":{"type":"object","additionalProperties":{"oneOf":[{"type":"string","uniqueKey":"additional_data.additionalProperties.oneOf.0","typeLabel":"string"},{"type":"array","items":{"type":"string","uniqueKey":"additional_data.additionalProperties.oneOf.1.items.[INDEX]","typeLabel":"string"},"uniqueKey":"additional_data.additionalProperties.oneOf.1","typeLabel":"string[]"}],"uniqueKey":"additional_data.additionalProperties","typeLabel":"string | string[]"},"uniqueKey":"additional_data","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"object":"error","message":"\u003cstring>","code":"row_limit_exceeded","status":406,"additional_data":{}}}},"exampleType":"generated"}},"exampleType":"generated"},"6dbdbc22-dec9-4b7e-a7ef-96bd97deae14":{"description":"","content":{"application/json":{"schema":{"type":"object","required":["code","status","object","message"],"properties":{"object":{"const":"error","isRequired":true,"uniqueKey":"object","typeLabel":"any"},"message":{"type":"string","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"code":{"enum":["conflict_error","idempotency_key_reused","agent_deleted"],"type":"string","isRequired":true,"uniqueKey":"code","typeLabel":"enum\u003cstring>"},"status":{"const":409,"isRequired":true,"uniqueKey":"status","typeLabel":"any"},"additional_data":{"type":"object","additionalProperties":{"oneOf":[{"type":"string","uniqueKey":"additional_data.additionalProperties.oneOf.0","typeLabel":"string"},{"type":"array","items":{"type":"string","uniqueKey":"additional_data.additionalProperties.oneOf.1.items.[INDEX]","typeLabel":"string"},"uniqueKey":"additional_data.additionalProperties.oneOf.1","typeLabel":"string[]"}],"uniqueKey":"additional_data.additionalProperties","typeLabel":"string | string[]"},"uniqueKey":"additional_data","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"object":"error","message":"\u003cstring>","code":"conflict_error","status":409,"additional_data":{}}}},"exampleType":"generated"}},"exampleType":"generated"},"5f952344-bb71-4a8b-846c-fc20ae6ea6b2":{"description":"","content":{"application/json":{"schema":{"type":"object","required":["code","status","object","message"],"properties":{"object":{"const":"error","isRequired":true,"uniqueKey":"object","typeLabel":"any"},"message":{"type":"string","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"code":{"enum":["rate_limited"],"type":"string","isRequired":true,"uniqueKey":"code","typeLabel":"enum\u003cstring>"},"status":{"const":429,"isRequired":true,"uniqueKey":"status","typeLabel":"any"},"additional_data":{"type":"object","additionalProperties":{"oneOf":[{"type":"string","uniqueKey":"additional_data.additionalProperties.oneOf.0","typeLabel":"string"},{"type":"array","items":{"type":"string","uniqueKey":"additional_data.additionalProperties.oneOf.1.items.[INDEX]","typeLabel":"string"},"uniqueKey":"additional_data.additionalProperties.oneOf.1","typeLabel":"string[]"}],"uniqueKey":"additional_data.additionalProperties","typeLabel":"string | string[]"},"uniqueKey":"additional_data","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"object":"error","message":"\u003cstring>","code":"rate_limited","status":429,"additional_data":{}}}},"exampleType":"generated"}},"exampleType":"generated"},"11a6d732-f6e8-475d-b60d-88f86330fdfb":{"description":"","content":{"application/json":{"schema":{"type":"object","required":["code","status","object","message"],"properties":{"object":{"const":"error","isRequired":true,"uniqueKey":"object","typeLabel":"any"},"message":{"type":"string","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"code":{"enum":["internal_server_error"],"type":"string","isRequired":true,"uniqueKey":"code","typeLabel":"enum\u003cstring>"},"status":{"const":500,"isRequired":true,"uniqueKey":"status","typeLabel":"any"},"additional_data":{"type":"object","additionalProperties":{"oneOf":[{"type":"string","uniqueKey":"additional_data.additionalProperties.oneOf.0","typeLabel":"string"},{"type":"array","items":{"type":"string","uniqueKey":"additional_data.additionalProperties.oneOf.1.items.[INDEX]","typeLabel":"string"},"uniqueKey":"additional_data.additionalProperties.oneOf.1","typeLabel":"string[]"}],"uniqueKey":"additional_data.additionalProperties","typeLabel":"string | string[]"},"uniqueKey":"additional_data","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"object":"error","message":"\u003cstring>","code":"internal_server_error","status":500,"additional_data":{}}}},"exampleType":"generated"}},"exampleType":"generated"},"1cea220f-94e2-4638-937e-8d6679c62fd9":{"description":"","content":{"application/json":{"schema":{"type":"object","required":["code","status","object","message"],"properties":{"object":{"const":"error","isRequired":true,"uniqueKey":"object","typeLabel":"any"},"message":{"type":"string","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"code":{"enum":["service_unavailable"],"type":"string","isRequired":true,"uniqueKey":"code","typeLabel":"enum\u003cstring>"},"status":{"const":503,"isRequired":true,"uniqueKey":"status","typeLabel":"any"},"additional_data":{"type":"object","additionalProperties":{"oneOf":[{"type":"string","uniqueKey":"additional_data.additionalProperties.oneOf.0","typeLabel":"string"},{"type":"array","items":{"type":"string","uniqueKey":"additional_data.additionalProperties.oneOf.1.items.[INDEX]","typeLabel":"string"},"uniqueKey":"additional_data.additionalProperties.oneOf.1","typeLabel":"string[]"}],"uniqueKey":"additional_data.additionalProperties","typeLabel":"string | string[]"},"uniqueKey":"additional_data","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"object":"error","message":"\u003cstring>","code":"service_unavailable","status":503,"additional_data":{}}}},"exampleType":"generated"}},"exampleType":"generated"},"55ea7a6b-67a1-405c-8667-a78fc456b79b":{"description":"","content":{"application/json":{"schema":{"type":"object","required":["code","status","object","message"],"properties":{"object":{"const":"error","isRequired":true,"uniqueKey":"object","typeLabel":"any"},"message":{"type":"string","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"code":{"enum":["gateway_timeout"],"type":"string","isRequired":true,"uniqueKey":"code","typeLabel":"enum\u003cstring>"},"status":{"const":504,"isRequired":true,"uniqueKey":"status","typeLabel":"any"},"additional_data":{"type":"object","additionalProperties":{"oneOf":[{"type":"string","uniqueKey":"additional_data.additionalProperties.oneOf.0","typeLabel":"string"},{"type":"array","items":{"type":"string","uniqueKey":"additional_data.additionalProperties.oneOf.1.items.[INDEX]","typeLabel":"string"},"uniqueKey":"additional_data.additionalProperties.oneOf.1","typeLabel":"string[]"}],"uniqueKey":"additional_data.additionalProperties","typeLabel":"string | string[]"},"uniqueKey":"additional_data","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"object":"error","message":"\u003cstring>","code":"gateway_timeout","status":504,"additional_data":{}}}},"exampleType":"generated"}},"exampleType":"generated"},"c7a29a61-44c1-4462-810d-ed68b77fe767":{"description":"","content":{"application/json":{"schema":{"type":"object","required":["code","status","object","message"],"properties":{"object":{"const":"error","isRequired":true,"uniqueKey":"object","typeLabel":"any"},"message":{"type":"string","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"code":{"enum":["service_overload"],"type":"string","isRequired":true,"uniqueKey":"code","typeLabel":"enum\u003cstring>"},"status":{"const":529,"isRequired":true,"uniqueKey":"status","typeLabel":"any"},"additional_data":{"type":"object","additionalProperties":{"oneOf":[{"type":"string","uniqueKey":"additional_data.additionalProperties.oneOf.0","typeLabel":"string"},{"type":"array","items":{"type":"string","uniqueKey":"additional_data.additionalProperties.oneOf.1.items.[INDEX]","typeLabel":"string"},"uniqueKey":"additional_data.additionalProperties.oneOf.1","typeLabel":"string[]"}],"uniqueKey":"additional_data.additionalProperties","typeLabel":"string | string[]"},"uniqueKey":"additional_data","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"object":"error","message":"\u003cstring>","code":"service_overload","status":529,"additional_data":{}}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"23c7697b-01d6-4756-9e53-15c190c2a020":{"bearerAuth":{"type":"http","scheme":"bearer","scopes":[],"schemeName":"bearerAuth"}}},"servers":{"2c852185-817e-41b9-a119-a2d9c7a56bef":{"url":"https://api.notion.com"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","scopes":[],"schemeName":"bearerAuth"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Bearer authentication header of the form `Bearer \u003ctoken>`, where `\u003ctoken>` is your auth token.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"bearerAuth","name":"Authorization"}],"title":"bearerAuth"}]},"originalFileLocation":"openapi.json"},"subdomain":"notion-demo","siteName":"Notion Docs","title":"Retrieve a database - Notion Docs","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-12T19:31:03.619Z","originalFileLocation":"reference/retrieve-database.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"application-name\" content=\"Notion Docs\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/notion-demo/1PaJq9z3waub4TpE/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/notion-demo/1PaJq9z3waub4TpE/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/notion-demo/1PaJq9z3waub4TpE/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/notion-demo/1PaJq9z3waub4TpE/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/notion-demo/1PaJq9z3waub4TpE/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/notion-demo/1PaJq9z3waub4TpE/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/notion-demo/1PaJq9z3waub4TpE/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/notion-demo/1PaJq9z3waub4TpE/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/notion-demo/1PaJq9z3waub4TpE/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Retrieve a database - Notion Docs\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Notion Docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://developers.notion.com/reference/retrieve-database\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://notion-demo.mintlify.site/images/og-image.png\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Retrieve a database - Notion Docs\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://notion-demo.mintlify.site/images/og-image.png\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/notion-demo/1PaJq9z3waub4TpE/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Notion Docs\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#000\">\u003clink data-mint-head rel=\"canonical\" href=\"https://developers.notion.com/reference/retrieve-database\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/reference/retrieve-database.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://developers.notion.com/#organization\",\"name\":\"Notion Docs\",\"url\":\"https://developers.notion.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/notion-demo/5YdhSbldE14t5Rna/logo/light.svg?fit=max\u0026auto=format\u0026n=5YdhSbldE14t5Rna\u0026q=85\u0026s=249f5693ad929397409bf9b51d6d539d\"}},{\"@type\":\"WebSite\",\"@id\":\"https://developers.notion.com#website\",\"name\":\"Notion Docs\",\"url\":\"https://developers.notion.com\",\"publisher\":{\"@id\":\"https://developers.notion.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://developers.notion.com/reference/retrieve-database#webpage\",\"url\":\"https://developers.notion.com/reference/retrieve-database\",\"name\":\"Retrieve a database\",\"dateModified\":\"2026-11-12T19:31:03.619Z\",\"isPartOf\":{\"@id\":\"https://developers.notion.com#website\"},\"breadcrumb\":{\"@id\":\"https://developers.notion.com/reference/retrieve-database#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://developers.notion.com/reference/retrieve-database#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Endpoints\",\"item\":\"https://developers.notion.com/reference/authentication\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Databases\",\"item\":\"https://developers.notion.com/reference/create-database\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Retrieve a database\",\"item\":\"https://developers.notion.com/reference/retrieve-database\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://developers.notion.com/reference/retrieve-database#apireference\",\"headline\":\"Retrieve a database\",\"name\":\"Retrieve a database\",\"url\":\"https://developers.notion.com/reference/retrieve-database\",\"mainEntityOfPage\":{\"@id\":\"https://developers.notion.com/reference/retrieve-database#webpage\"},\"image\":\"https://developers.notion.com/images/og-image.png\",\"dateModified\":\"2026-11-12T19:31:03.619Z\",\"publisher\":{\"@id\":\"https://developers.notion.com/#organization\"},\"isPartOf\":{\"@id\":\"https://developers.notion.com#website\"}}]}\u003c/script>","agentPointerHref":"/reference/retrieve-database.md","siteName":"Notion Docs","nav":{"global":{"anchors":[]},"tabs":[{"tab":"Guides","pages":[{"title":"Guides","href":"/guides/notion-api/quick-start"}]},{"tab":"API Reference","groups":[{"group":"Notion API","pages":[{"title":"Introduction","href":"/reference/intro"},{"title":"Pagination","href":"/reference/pagination"},{"title":"Connection capabilities","href":"/reference/capabilities"},{"group":"Webhooks","pages":[{"title":"Webhooks","sidebarTitle":"Overview","href":"/reference/webhooks"},{"title":"Event types \u0026 delivery","href":"/reference/webhooks-events-delivery"}]},{"title":"Request limits","href":"/reference/request-limits"},{"title":"Workspace block limits","href":"/reference/workspace-block-limits"},{"title":"Status codes","href":"/reference/status-codes"},{"group":"Versioning","pages":[{"title":"Versioning","sidebarTitle":"Overview","href":"/reference/versioning"},{"title":"Changes by version","href":"/reference/changes-by-version"}]}]},{"group":"Objects","pages":[{"group":"Block","pages":[{"title":"Block","sidebarTitle":"Overview","href":"/reference/block"},{"title":"Rich text","href":"/reference/rich-text"}]},{"group":"Page","pages":[{"title":"Page","sidebarTitle":"Overview","href":"/reference/page"},{"group":"Page properties","pages":[{"title":"Page property values","sidebarTitle":"Page values","href":"/reference/page-property-values"},{"title":"Page property items","sidebarTitle":"Property items","href":"/reference/property-item-object"}]}]},{"title":"Database","href":"/reference/database"},{"group":"Data source","pages":[{"title":"Data source","sidebarTitle":"Overview","href":"/reference/data-source"},{"title":"Data source properties","sidebarTitle":"Property schemas","href":"/reference/property-object"}]},{"title":"View","href":"/reference/view"},{"group":"Comment","pages":[{"title":"Comment","sidebarTitle":"Overview","href":"/reference/comment-object"},{"title":"Comment attachment","href":"/reference/comment-attachment"},{"title":"Comment display name","href":"/reference/comment-display-name"}]},{"group":"File","pages":[{"title":"File","sidebarTitle":"Overview","href":"/reference/file-object"},{"title":"File Upload","href":"/reference/file-upload"}]},{"title":"User","href":"/reference/user"},{"title":"Parent","href":"/reference/parent-object"},{"title":"Emoji and icon","href":"/reference/emoji-and-icon"},{"title":"Unfurl attribute (Link Previews)","href":"/reference/unfurl-attribute-object"}]},{"group":"Endpoints","pages":[{"group":"Authentication","pages":[{"title":"Authentication","sidebarTitle":"Overview","href":"/reference/authentication"},{"title":"Create a token","openapi":"post /v1/oauth/token","href":"/reference/create-a-token"},{"openapi":"post /v1/oauth/introspect","title":"Introspect a token","href":"/reference/introspect-token"},{"openapi":"post /v1/oauth/revoke","title":"Revoke a token","href":"/reference/revoke-token"},{"title":"Refresh a token","openapi":"post /v1/oauth/token","href":"/reference/refresh-a-token"}]},{"group":"Async tasks","icon":"/icons/nds/arrowCircleLoopForward.svg","pages":[{"openapi":"openapi.json GET /v1/async_tasks/{task_id}","title":"Retrieve an async task","href":"/reference/retrieve-async-task"}]},{"group":"Blocks","pages":[{"openapi":"patch /v1/blocks/{block_id}/children","title":"Append block children","href":"/reference/patch-block-children"},{"openapi":"get /v1/blocks/{block_id}","title":"Retrieve a block","href":"/reference/retrieve-a-block"},{"openapi":"get /v1/blocks/{block_id}/children","title":"Retrieve block children","href":"/reference/get-block-children"},{"openapi":"patch /v1/blocks/{block_id}","title":"Update a block","href":"/reference/update-a-block"},{"openapi":"delete /v1/blocks/{block_id}","title":"Delete a block","href":"/reference/delete-a-block"},{"title":"Create a meeting note","openapi":"post /v1/blocks/meeting_notes","href":"/reference/create-meeting-note"},{"openapi":"post /v1/blocks/meeting_notes/query","title":"Query meeting notes","href":"/reference/query-meeting-notes"},{"title":"Create a full-page meeting note","openapi":"post /v1/meeting_notes","href":"/reference/create-meeting-note-page"},{"title":"Link a full-page meeting note to a calendar event","openapi":"patch /v1/meeting_notes/{meeting_note_id}","href":"/reference/update-meeting-note-page"}]},{"group":"Pages","pages":[{"openapi":"post /v1/pages","title":"Create a page","href":"/reference/post-page"},{"openapi":"get /v1/pages/{page_id}","title":"Retrieve a page","href":"/reference/retrieve-a-page"},{"openapi":"get /v1/pages/{page_id}/properties/{property_id}","title":"Retrieve a page property item","href":"/reference/retrieve-a-page-property"},{"openapi":"post /v1/pages/{page_id}/move","title":"Move a page","href":"/reference/move-page"},{"group":"Update page","icon":"/icons/nds/pencil.svg","pages":[{"openapi":"patch /v1/pages/{page_id}","title":"Update page","href":"/reference/patch-page"},{"title":"Trash a page","icon":"trash-can","href":"/reference/trash-page"}]},{"group":"Markdown content","icon":"/icons/nds/poundSign.svg","pages":[{"openapi":"get /v1/pages/{page_id}/markdown","title":"Retrieve a page as markdown","href":"/reference/retrieve-page-markdown"},{"openapi":"patch /v1/pages/{page_id}/markdown","title":"Update a page's content as markdown","href":"/reference/update-page-markdown"}]}]},{"group":"Databases","pages":[{"openapi":"post /v1/databases","title":"Create a database","href":"/reference/create-database"},{"openapi":"patch /v1/databases/{database_id}","description":"Updates the attributes — the title, description, icon, or cover, etc. — of a specified database.","title":"Update a database","href":"/reference/update-database"},{"openapi":"get /v1/databases/{database_id}","title":"Retrieve a database","href":"/reference/retrieve-database"}]},{"group":"Data sources","pages":[{"openapi":"post /v1/data_sources","title":"Create a data source","description":null,"href":"/reference/create-a-data-source"},{"openapi":"get /v1/data_sources/{data_source_id}","title":"Retrieve a data source","href":"/reference/retrieve-a-data-source"},{"title":"List data source templates","openapi":"get /v1/data_sources/{data_source_id}/templates","href":"/reference/list-data-source-templates"},{"group":"Update a data source","icon":"/icons/nds/pencil.svg","pages":[{"openapi":"patch /v1/data_sources/{data_source_id}","title":"Update a data source","href":"/reference/update-a-data-source"},{"title":"Update data source properties","icon":"table-columns","href":"/reference/update-data-source-properties"}]},{"group":"Query a data source","icon":"/icons/nds/clipboard.svg","pages":[{"openapi":"post /v1/data_sources/{data_source_id}/query","title":"Query a data source","href":"/reference/query-a-data-source"},{"title":"Filter data source entries","icon":"filter","href":"/reference/filter-data-source-entries"},{"title":"Sort data source entries","icon":"arrow-down-1-9","href":"/reference/sort-data-source-entries"}]}]},{"group":"Databases (deprecated)","pages":[{"title":"Create a database","openapi":"post /v1/databases","href":"/reference/create-a-database"},{"openapi":"get /v1/databases/{database_id}","title":"Retrieve a database","href":"/reference/retrieve-a-database"},{"openapi":"get /v1/databases","title":null,"href":"/reference/get-databases"},{"group":"Query a database","pages":[{"openapi":"post /v1/databases/{database_id}/query","sidebarTitle":"Overview","title":null,"href":"/reference/post-database-query"},{"title":"Filter database entries","href":"/reference/post-database-query-filter"},{"title":"Sort database entries","href":"/reference/post-database-query-sort"}]},{"group":"Update a database","pages":[{"openapi":"patch /v1/databases/{database_id}","title":"Update a database","href":"/reference/update-a-database"},{"title":"Update database properties (legacy)","sidebarTitle":"Update properties","href":"/reference/update-property-schema-object"}]}]},{"group":"Comments","pages":[{"title":"Create comment","openapi":"post /v1/comments","href":"/reference/create-a-comment"},{"title":"Update comment","openapi":"patch /v1/comments/{comment_id}","href":"/reference/update-a-comment"},{"title":"Delete comment","openapi":"delete /v1/comments/{comment_id}","href":"/reference/delete-a-comment"},{"openapi":"get /v1/comments/{comment_id}","title":"Retrieve a comment","href":"/reference/retrieve-comment"},{"openapi":"get /v1/comments","title":"List comments","href":"/reference/list-comments"}]},{"group":"Views","pages":[{"openapi":"post /v1/views","title":"Create a view","href":"/reference/create-view"},{"openapi":"get /v1/views/{view_id}","title":"Retrieve a view","href":"/reference/retrieve-a-view"},{"openapi":"patch /v1/views/{view_id}","title":"Update a view","href":"/reference/update-a-view"},{"openapi":"delete /v1/views/{view_id}","title":"Delete a view","href":"/reference/delete-view"},{"openapi":"get /v1/views","title":"List views","href":"/reference/list-views"},{"group":"View queries","icon":"/icons/nds/clipboard.svg","pages":[{"openapi":"post /v1/views/{view_id}/queries","title":"Create a view query","href":"/reference/create-view-query"},{"openapi":"get /v1/views/{view_id}/queries/{query_id}","title":"Get view query results","href":"/reference/get-view-query-results"},{"openapi":"delete /v1/views/{view_id}/queries/{query_id}","title":"Delete a view query","href":"/reference/delete-view-query"}]}]},{"group":"File Uploads","pages":[{"openapi":"post /v1/file_uploads","title":"Create a file upload","href":"/reference/create-file"},{"title":"Send a file upload","openapi":"post /v1/file_uploads/{file_upload_id}/send","sidebarTitle":"Send a file upload","href":"/reference/upload-file"},{"title":"Complete a file upload","openapi":"post /v1/file_uploads/{file_upload_id}/complete","href":"/reference/complete-file-upload"},{"openapi":"get /v1/file_uploads/{file_upload_id}","title":"Retrieve a file upload","href":"/reference/retrieve-file-upload"},{"openapi":"get /v1/file_uploads","title":"List file uploads","href":"/reference/list-file-uploads"}]},{"group":"Search","pages":[{"group":"Search by title","icon":"/icons/nds/magnifyingGlass.svg","pages":[{"openapi":"post /v1/search","title":"Search by title","href":"/reference/post-search"}]},{"title":"Search optimizations and limitations","icon":"bolt","href":"/reference/search-optimizations-and-limitations"}]},{"group":"Users","pages":[{"openapi":"get /v1/users","title":"List all users","href":"/reference/get-users"},{"openapi":"get /v1/users/{user_id}","title":"Retrieve a user","href":"/reference/get-user"},{"openapi":"get /v1/users/me","title":"Retrieve your token's bot user","href":"/reference/get-self"}]},{"group":"Custom emojis","pages":[{"openapi":"get /v1/custom_emojis","title":"List custom emojis","href":"/reference/list-custom-emojis"}]},{"group":"Agents","pages":[{"title":"Query agents","openapi":"post /v1/agents/query","href":"/reference/notion-agent-apis/query-agents"},{"title":"Retrieve an agent","openapi":"get /v1/agents/{agent_id}","href":"/reference/notion-agent-apis/retrieve-agent"},{"title":"Retrieve agent insights","openapi":"get /v1/agents/{agent_id}/insights","href":"/reference/notion-agent-apis/retrieve-agent-insights"},{"title":"Update an agent","openapi":"patch /v1/agents/{agent_id}","href":"/reference/notion-agent-apis/update-agent"},{"title":"Update agent status","openapi":"patch /v1/agents/{agent_id}/status","href":"/reference/notion-agent-apis/update-agent-status"},{"title":"Update an agent credit limit","openapi":"patch /v1/agents/{agent_id}/credit_limit","href":"/reference/notion-agent-apis/update-agent-credit-limit"},{"title":"Delete an agent","openapi":"delete /v1/agents/{agent_id}","href":"/reference/notion-agent-apis/delete-agent"},{"title":"Batch manage agent","openapi":"post /v1/agents/batch","href":"/reference/notion-agent-apis/batch-manage-agent"},{"title":"Create or update a session","openapi":"post /v1/sessions","href":"/reference/notion-agent-apis/update-session"},{"title":"Retrieve a session","openapi":"get /v1/sessions/{session_id}","href":"/reference/notion-agent-apis/retrieve-session"},{"title":"Query sessions","openapi":"post /v1/sessions/query","href":"/reference/notion-agent-apis/query-sessions"},{"title":"Query session events","openapi":"post /v1/sessions/{session_id}/events/query","href":"/reference/notion-agent-apis/query-session-events"},{"title":"Cancel a session","openapi":"post /v1/sessions/{session_id}/cancel","href":"/reference/notion-agent-apis/cancel-session"}]},{"group":"Agent Skills","pages":[{"title":"List plugins","openapi":"openapi.json GET /v1/ai/plugins","href":"/reference/agent-skills/list-skills-plugins"},{"title":"Get plugin","openapi":"openapi.json GET /v1/ai/plugins/{id}","href":"/reference/agent-skills/get-plugin-directory"},{"title":"Get skill","openapi":"openapi.json GET /v1/ai/skills/{id}","href":"/reference/agent-skills/get-skill-directory"},{"title":"Upload a skill","openapi":"POST /v1/ai/skills/{id}/upload","href":"/reference/agent-skills/upload-skill"}]}]},{"group":"Webhook events","pages":[{"group":"Pages","pages":[{"title":"Page created","openapi":"openapi.json webhook pageCreated","href":"/reference/webhooks/page-created"},{"title":"Page content updated","openapi":"openapi.json webhook pageContentUpdated","href":"/reference/webhooks/page-content-updated"},{"title":"Page properties updated","openapi":"openapi.json webhook pagePropertiesUpdated","href":"/reference/webhooks/page-properties-updated"},{"title":"Page moved","openapi":"openapi.json webhook pageMoved","href":"/reference/webhooks/page-moved"},{"title":"Page deleted","openapi":"openapi.json webhook pageDeleted","href":"/reference/webhooks/page-deleted"},{"title":"Page undeleted","openapi":"openapi.json webhook pageUndeleted","href":"/reference/webhooks/page-undeleted"},{"title":"Page locked","openapi":"openapi.json webhook pageLocked","href":"/reference/webhooks/page-locked"},{"title":"Page unlocked","openapi":"openapi.json webhook pageUnlocked","href":"/reference/webhooks/page-unlocked"},{"title":"Page transcript deleted","openapi":"openapi.json webhook pageTranscriptionBlockTranscriptDeleted","href":"/reference/webhooks/page-transcription-block-transcript-deleted"}]},{"group":"Databases","pages":[{"title":"Database created","openapi":"openapi.json webhook databaseCreated","href":"/reference/webhooks/database-created"},{"title":"Database content updated","openapi":"openapi.json webhook databaseContentUpdated","href":"/reference/webhooks/database-content-updated"},{"title":"Database schema updated","openapi":"openapi.json webhook databaseSchemaUpdated","href":"/reference/webhooks/database-schema-updated"},{"title":"Database moved","openapi":"openapi.json webhook databaseMoved","href":"/reference/webhooks/database-moved"},{"title":"Database deleted","openapi":"openapi.json webhook databaseDeleted","href":"/reference/webhooks/database-deleted"},{"title":"Database undeleted","openapi":"openapi.json webhook databaseUndeleted","href":"/reference/webhooks/database-undeleted"}]},{"group":"Data sources","pages":[{"title":"Data source created","openapi":"openapi.json webhook dataSourceCreated","href":"/reference/webhooks/data-source-created"},{"title":"Data source content updated","openapi":"openapi.json webhook dataSourceContentUpdated","href":"/reference/webhooks/data-source-content-updated"},{"title":"Data source schema updated","openapi":"openapi.json webhook dataSourceSchemaUpdated","href":"/reference/webhooks/data-source-schema-updated"},{"title":"Data source moved","openapi":"openapi.json webhook dataSourceMoved","href":"/reference/webhooks/data-source-moved"},{"title":"Data source deleted","openapi":"openapi.json webhook dataSourceDeleted","href":"/reference/webhooks/data-source-deleted"},{"title":"Data source undeleted","openapi":"openapi.json webhook dataSourceUndeleted","href":"/reference/webhooks/data-source-undeleted"}]},{"group":"Comments","pages":[{"title":"Comment created","openapi":"openapi.json webhook commentCreated","href":"/reference/webhooks/comment-created"},{"title":"Comment updated","openapi":"openapi.json webhook commentUpdated","href":"/reference/webhooks/comment-updated"},{"title":"Comment deleted","openapi":"openapi.json webhook commentDeleted","href":"/reference/webhooks/comment-deleted"}]},{"group":"File uploads","pages":[{"title":"File upload created","openapi":"openapi.json webhook fileUploadCreated","href":"/reference/webhooks/file-upload-created"},{"title":"File upload completed","openapi":"openapi.json webhook fileUploadCompleted","href":"/reference/webhooks/file-upload-completed"},{"title":"File upload expired","openapi":"openapi.json webhook fileUploadExpired","href":"/reference/webhooks/file-upload-expired"},{"title":"File upload failed","openapi":"openapi.json webhook fileUploadUploadFailed","href":"/reference/webhooks/file-upload-upload-failed"}]},{"group":"Views","pages":[{"title":"View created","openapi":"openapi.json webhook viewCreated","href":"/reference/webhooks/view-created"},{"title":"View updated","openapi":"openapi.json webhook viewUpdated","href":"/reference/webhooks/view-updated"},{"title":"View deleted","openapi":"openapi.json webhook viewDeleted","href":"/reference/webhooks/view-deleted"}]}]}]},{"tab":"CLI Reference","pages":[{"title":"CLI Reference","href":"/cli/get-started/overview"}]},{"tab":"Workers","pages":[{"title":"Workers","href":"/workers/get-started/overview"}]},{"tab":"Custom blocks","hidden":true,"pages":[{"title":"Custom blocks","href":"/custom-blocks/overview"}]},{"tab":"Admin API","hidden":false,"pages":[{"title":"Admin API","href":"/reference/admin/intro"}]},{"tab":"Changelog","pages":[{"title":"Changelog","href":"/page/changelog"}]},{"tab":"Examples","pages":[{"title":"Examples","href":"/page/examples"}]},{"tab":"Prompts","hidden":true,"searchable":true,"pages":[{"title":"Prompts","href":"/prompts/setup"}]},{"tab":"Internal","hidden":true,"pages":[{"title":"Internal","href":"/guides/internal/link-previews/building-a-link-preview"}]},{"tab":"Unreleased APIs","hidden":true,"pages":[{"title":"Unreleased APIs","href":"/reference/unreleased/external-agent-apis/start-external-agent-session"}]}]},"basePath":"","title":"Retrieve a database - Notion Docs","deploymentId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","buildId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","07c022d89b","a74be98ba7","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-CiUHMMOm.js","snippetPresets-BgfXU7Bw.js","utils-DWvOwgy_.js","style-to-object-BY3JEAdk.js","utils-BN7RXSMJ.js","v4-DIgz8zy6.js","addUniqueKeysToSchema-CFw8bq89.js","conditional-requirements-CFM0id0Q.js","cloneDeep-CAwdfOU2.js","_Uint8Array-BJr8e-ZL.js","isObject-FP1Yky1u.js","ApiExamples-XX0UgMZK.js","usePlaygroundInputsStore-DXDFSa1V.js","shallow-CdX5aREi.js","isEqual-CoOaxexF.js","CodeSnippets-Cg2wpzWm.js","CodeSnippet-D_HwgQO_.js","getApiPlaygroundDisplay-CmCoerhe.js","Page-CVJ-f_k1.js","DynamicMarkdown-CQM9Bhbv.js","SectionHeading-DpbrP8nQ.js","icon-BPCgijHy.js","MethodPill-GQ8DuY0c.js","getPastedJson-Cb5mT31m.js","Check2Icon-a7bUI6e8.js","axios-CsQoIw0U.js","Frame-D0FT0qQs.js","zoom-image-lightbox-BQ4tbj_9.js","lightbox-handle-r17bVUz3.js","Markdown-CX2QY19L.js","AssistantPageLink-CY3bFglh.js","dist-Dl6_zDnT.js","lib-DMeTj1gb.js","lib-B8HbPgcC.js","katex-Dbtb6Wk7.js","html-void-elements-mCSPHezU.js","marked.esm-CZWythHk.js"]}