Deprecated as of version 2025-09-03This page describes the API for versions up to and including 2022-06-28. In the new 2025-09-03 version, the concepts of databases and data sources were split up, as described in Upgrading to 2025-09-03.Refer to the new APIs instead:
Retrieves a database object — information that describes the structure and columns of a database — for a provided database ID. The response adheres to any limits to a connection’s capabilities.To fetch database rows rather than columns, use the Query a database endpoint.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.
Database relations must be shared with your connectionTo retrieve database properties from database relations, the related database must be shared with your connection in addition to the database being retrieved. If the related database is not shared, properties based on relations will not be included in the API response.
The Notion API does not support retrieving linked databases.To fetch the information in a linked database, share the original source database with your Notion connection.
Authorizations
Authorization
string
header
required
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":"6af7d0e06671f903af2c144d","clientVersion":"0.0.4142","searchFilterCounts":[{"language":"default","tag":"API Reference","count":140},{"language":"default","tag":"Endpoints","count":133},{"language":"default","tag":"Guides","count":62},{"language":"default","tag":"Admin API","count":58},{"language":"default","tag":"Webhook events","count":31},{"language":"default","tag":"Agents","count":23},{"language":"default","tag":"Objects","count":18},{"language":"default","tag":"Notion API","count":17},{"language":"default","tag":"Data APIs","count":17},{"language":"default","tag":"Pages","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":"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":"llms-txt-v2","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-a-database","slug":"/reference/retrieve-a-database","pageMetadata":{"openapi":"get /v1/databases/{database_id}","title":"Retrieve a database","description":null,"href":"/reference/retrieve-a-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`,strong:`strong`,ul:`ul`,..._provideComponents(),...props.components},{Frame,Heading,Info,OptimizedImage,Warning}=_components;if(!Frame)_missingMdxReference(`Frame`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Info)_missingMdxReference(`Info`,true);if(!OptimizedImage)_missingMdxReference(`OptimizedImage`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsxs(Warning,{children:[_jsx(_components.p,{children:_jsx(_components.strong,{children:`Deprecated as of version 2025-09-03`})}),_jsxs(_components.p,{children:[`This page describes the API for versions up to and including `,_jsx(_components.code,{children:`2022-06-28`}),`. In the new `,_jsx(_components.code,{children:`2025-09-03`}),` version, the concepts of databases and data sources were split up, as described in `,_jsx(_components.a,{href:`/guides/get-started/upgrade-guide-2025-09-03`,children:`Upgrading to 2025-09-03`}),`.`]}),_jsx(_components.p,{children:`Refer to the new APIs instead:`}),_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:_jsx(_components.a,{href:`/reference/retrieve-database`,children:`Retrieve a database`})}),`\n`,_jsx(_components.li,{children:_jsx(_components.a,{href:`/reference/retrieve-a-data-source`,children:`Retrieve a data source`})}),`\n`]})]}),`\n`,_jsxs(_components.p,{children:[`Retrieves a `,_jsx(_components.a,{href:`/reference/database`,children:`database object`}),` — information that describes the structure and columns of a database — for a provided database ID. The response adheres to any limits to a connection’s capabilities.`]}),`\n`,_jsxs(_components.p,{children:[`To fetch database rows rather than columns, use the `,_jsx(_components.a,{href:`/reference/post-database-query`,children:`Query a database`}),` endpoint.`]}),`\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-1.png?fit=max\u0026auto=format\u0026n=S-I3qLQnwRa7HjdK\u0026q=85\u0026s=00a19b68b92cd013cdc0f8867427eb44`,alt:`1340`,\"data-og-width\":`1340`,width:`1340`,\"data-og-height\":`550`,height:`550`,\"data-path\":`images/reference/image-1.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/notion-demo/S-I3qLQnwRa7HjdK/images/reference/image-1.png?w=280\u0026fit=max\u0026auto=format\u0026n=S-I3qLQnwRa7HjdK\u0026q=85\u0026s=619d6c3987ad5749bf23af7818319fa2 280w, https://mintcdn.com/notion-demo/S-I3qLQnwRa7HjdK/images/reference/image-1.png?w=560\u0026fit=max\u0026auto=format\u0026n=S-I3qLQnwRa7HjdK\u0026q=85\u0026s=169ae1bb1ec28afc5a2a76da22509aa7 560w, https://mintcdn.com/notion-demo/S-I3qLQnwRa7HjdK/images/reference/image-1.png?w=840\u0026fit=max\u0026auto=format\u0026n=S-I3qLQnwRa7HjdK\u0026q=85\u0026s=721d8511030842a08474ddd98a6b384f 840w, https://mintcdn.com/notion-demo/S-I3qLQnwRa7HjdK/images/reference/image-1.png?w=1100\u0026fit=max\u0026auto=format\u0026n=S-I3qLQnwRa7HjdK\u0026q=85\u0026s=7916e5aadb53f7b659e522154193debe 1100w, https://mintcdn.com/notion-demo/S-I3qLQnwRa7HjdK/images/reference/image-1.png?w=1650\u0026fit=max\u0026auto=format\u0026n=S-I3qLQnwRa7HjdK\u0026q=85\u0026s=3efcdcb414a369a7835d2745d192abaf 1650w, https://mintcdn.com/notion-demo/S-I3qLQnwRa7HjdK/images/reference/image-1.png?w=2500\u0026fit=max\u0026auto=format\u0026n=S-I3qLQnwRa7HjdK\u0026q=85\u0026s=dd872b0b759a00afe4d3cd4243877c8b 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`]}),`\n`,_jsxs(Info,{children:[_jsx(_components.p,{children:_jsx(_components.strong,{children:`Database relations must be shared with your connection`})}),_jsxs(_components.p,{children:[`To retrieve database properties from `,_jsx(_components.a,{href:`https://www.notion.com/help/relations-and-rollups#what-is-a-database-relation`,children:`database relations`}),`, the related database must be shared with your connection in addition to the database being retrieved. If the related database is not shared, properties based on relations will not be included in the API response.`]})]}),`\n`,_jsxs(Warning,{children:[_jsx(_components.p,{children:_jsx(_components.strong,{children:`The Notion API does not support retrieving linked databases.`})}),_jsxs(_components.p,{children:[`To fetch the information in a `,_jsx(_components.a,{href:`https://www.notion.com/help/guides/using-linked-databases`,children:`linked database`}),`, share the original source database with your Notion connection.`]})]})]})}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-a-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":["4133bc48-bf70-465c-af5f-0c8ee3c7f771","737a1ab0-cfc4-443a-b750-a0b7536f05a0"],"responses":{"200":"445facc5-c799-490f-ac51-7befbcae6f6a","400":"44ea6c2a-7000-4305-bf42-d2292b3f832b","401":"7ca9df8e-9c26-4963-a88d-e93b3f30e7bb","403":"bc9e8db9-aa3d-45d7-9b68-6166e4975529","404":"f1ae1d13-cef2-4707-83b2-745514418a72","406":"f829086a-d6a1-4979-a4cd-1411eb3c4157","409":"c4c3328a-f501-4dd2-867c-123079419ba5","429":"939bb499-faaa-484c-a78c-08f6864e3050","500":"98be1fad-28ef-4ee4-8995-e4267b2912e0","503":"37bb687e-35d3-4773-8553-99995b1e4744","504":"103d9c79-e9af-48a7-8177-8f80a4db59a1","529":"3d45ba36-d7aa-4909-b755-82cc471c1fda"},"method":"get","type":"path","servers":["1caefac3-d9a8-497b-9897-039fefef556a"],"security":["b6181260-ef0f-472c-af16-dec8530a4c38"],"path":"/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":{"4133bc48-bf70-465c-af5f-0c8ee3c7f771":{"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"}},"737a1ab0-cfc4-443a-b750-a0b7536f05a0":{"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":{"445facc5-c799-490f-ac51-7befbcae6f6a":{"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"},"44ea6c2a-7000-4305-bf42-d2292b3f832b":{"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"},"7ca9df8e-9c26-4963-a88d-e93b3f30e7bb":{"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"},"bc9e8db9-aa3d-45d7-9b68-6166e4975529":{"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"},"f1ae1d13-cef2-4707-83b2-745514418a72":{"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"},"f829086a-d6a1-4979-a4cd-1411eb3c4157":{"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"},"c4c3328a-f501-4dd2-867c-123079419ba5":{"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"},"939bb499-faaa-484c-a78c-08f6864e3050":{"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"},"98be1fad-28ef-4ee4-8995-e4267b2912e0":{"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"},"37bb687e-35d3-4773-8553-99995b1e4744":{"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"},"103d9c79-e9af-48a7-8177-8f80a4db59a1":{"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"},"3d45ba36-d7aa-4909-b755-82cc471c1fda":{"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":{"b6181260-ef0f-472c-af16-dec8530a4c38":{"bearerAuth":{"type":"http","scheme":"bearer","scopes":[],"schemeName":"bearerAuth"}}},"servers":{"1caefac3-d9a8-497b-9897-039fefef556a":{"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.629Z","originalFileLocation":"reference/retrieve-a-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-a-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-a-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-a-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-a-database#webpage\",\"url\":\"https://developers.notion.com/reference/retrieve-a-database\",\"name\":\"Retrieve a database\",\"dateModified\":\"2026-11-12T19:31:03.629Z\",\"isPartOf\":{\"@id\":\"https://developers.notion.com#website\"},\"breadcrumb\":{\"@id\":\"https://developers.notion.com/reference/retrieve-a-database#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://developers.notion.com/reference/retrieve-a-database#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Endpoints\",\"item\":\"https://developers.notion.com/reference/authentication\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Databases (deprecated)\",\"item\":\"https://developers.notion.com/reference/create-a-database\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Retrieve a database\",\"item\":\"https://developers.notion.com/reference/retrieve-a-database\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://developers.notion.com/reference/retrieve-a-database#apireference\",\"headline\":\"Retrieve a database\",\"name\":\"Retrieve a database\",\"url\":\"https://developers.notion.com/reference/retrieve-a-database\",\"mainEntityOfPage\":{\"@id\":\"https://developers.notion.com/reference/retrieve-a-database#webpage\"},\"image\":\"https://developers.notion.com/images/og-image.png\",\"dateModified\":\"2026-11-12T19:31:03.629Z\",\"publisher\":{\"@id\":\"https://developers.notion.com/#organization\"},\"isPartOf\":{\"@id\":\"https://developers.notion.com#website\"}}]}\u003c/script>","agentPointerHref":"/reference/retrieve-a-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"}]},{"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}","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","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","description":null,"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,"description":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","buildId":"dpl_G2Qd45vZZ7MkBiGF9yYx8ZsbbKXX","deploymentId":"dpl_G2Qd45vZZ7MkBiGF9yYx8ZsbbKXX","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","07c022d89b","a74be98ba7","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-NXj-Rqjv.js","utils-m0thOP-_.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-D13EKcfm.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema--XTdfsEb.js","snippetPresets-D3s4lmAH.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-ChURybxL.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-DL8CiXq2.js","shallow-DI2-YB2E.js","getApiPlaygroundDisplay-DxbW7b_y.js","CodeSnippet-CiNYS0pP.js","CodeSnippets-BT87bThu.js","Page-DSpdRuhM.js","getPastedJson-F_g_IrFQ.js","icon-CCIG5BAs.js","MethodPill-DY3E0jwx.js","DuplicateIcon-BN88xnEg.js","createIcon-VCCc5HO5.js","DynamicMarkdown-CaSwclgK.js","SectionHeading-DXV8nWhc.js","axios-vUo_bRtp.js","Frame-DL7q6v_h.js","zoom-image-lightbox-BLUesUNd.js","lightbox-handle-r17bVUz3.js","Markdown-CV32Re6G.js","clsx-5ydLOnhV.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-pFDdfjRe.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-BUGO5bPJ.js"]}