Learn about API change management and how to set the appropriate version in your connection.
The Admin API is versioned. Our API versions are named for the date the version is released. For example, our latest version is .Set the version by including a Notion-Version header. Setting this header is required.
Required HeaderThe Notion-Version header must be included in all REST API requests. This ensures the Notion API response is consistent with what your code expects.The most recent Notion-Version is .
{"docsConfig":{"theme":"aspen","$schema":"https://mintlify.com/docs.json","name":"Notion Docs","colors":{"primary":"#000","light":"#097fe8","dark":"#0075de"},"logo":{"light":"https://mintcdn.com/notion-demo/5YdhSbldE14t5Rna/logo/light.svg?fit=max\u0026auto=format\u0026n=5YdhSbldE14t5Rna\u0026q=85\u0026s=249f5693ad929397409bf9b51d6d539d","dark":"https://mintcdn.com/notion-demo/5YdhSbldE14t5Rna/logo/dark.svg?fit=max\u0026auto=format\u0026n=5YdhSbldE14t5Rna\u0026q=85\u0026s=a8404879d171debac543bb6c1482c909","href":"/"},"favicon":"https://mintcdn.com/notion-demo/LHm9qfrJYJOPRxs6/favicon.png?fit=max\u0026auto=format\u0026n=LHm9qfrJYJOPRxs6\u0026q=85\u0026s=0668f0b3334eef21f0cdc65b390d22d9","api":{"openapi":["openapi.json","openapi-undocumented.json","openapi-adminApi.json"]},"appearance":{"default":"system"},"background":{"color":{"light":"#ffffff","dark":"#0f0f0f"}},"navbar":{"links":[{"href":"https://www.notion.com/login","label":"Log in"}],"primary":{"type":"button","label":"Developer portal","href":"https://www.notion.so/developers"}},"footer":{"socials":{"x":"https://x.com/NotionDevs","slack":"https://join.slack.com/t/notiondevs/shared_invite/zt-3u9oid9q8-HLUBmMVWYK~g9HFo4U4raA"}},"seo":{"metatags":{"og:image":"/images/og-image.png"}},"fonts":{"family":"NotionInter"},"contextual":{"options":["copy","view","chatgpt","claude","perplexity","mcp","cursor","vscode"],"display":"header"},"interaction":{"drilldown":true},"styling":{"latex":false},"navigation":{"global":{"anchors":[]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"notion-demo","hasAudioNarration":false,"actualSubdomain":"notion-demo","customDomains":["developers.notion.com"],"gitSource":{"type":"github","owner":"makenotion","repo":"notion-next","deployBranch":"main","contentDirectory":"src/server-publicApiDocs","isPrivate":true,"mountPath":"","label":""},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"REMOVE_BRANDING":{"status":"ENABLED"},"CONTEXTUAL_FEEDBACK":{"status":"ENABLED"},"CODE_SNIPPET_FEEDBACK":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6b0108b082f0182f6b575fdd","clientVersion":"0.0.4270","searchFilterCounts":[{"language":"default","tag":"API Reference","count":142},{"language":"default","tag":"Endpoints","count":135},{"language":"default","tag":"Guides","count":77},{"language":"default","tag":"Admin API","count":58},{"language":"default","tag":"Webhook events","count":31},{"language":"default","tag":"Notion API","count":23},{"language":"default","tag":"Notion MCP","count":23},{"language":"default","tag":"Agents","count":23},{"language":"default","tag":"Objects","count":18},{"language":"default","tag":"Data APIs","count":17}]},"assistantConfig":{},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[],"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/admin/versioning","slug":"/reference/admin/versioning","pageMetadata":{"title":"Versioning","description":"Learn about API change management and how to set the appropriate version in your connection.","href":"/reference/admin/versioning"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Learn about API change management and how to set the appropriate version in your connection.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];const latestAdminApiVersion=_jsx(`code`,{children:`2026-06-01`});function _createMdxContent(props){const _components={code:`code`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,..._provideComponents(),...props.components},{CodeBlock,Warning}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`The Admin API is versioned. Our API versions are named for the date the version is released. For example, our latest version is `,latestAdminApiVersion,`.`]}),`\n`,_jsxs(_components.p,{children:[`Set the version by including a `,_jsx(_components.code,{children:`Notion-Version`}),` header. Setting this header is `,_jsx(_components.strong,{children:`required`}),`.`]}),`\n`,_jsx(CodeBlock,{filename:`cURL`,numberOfLines:`3`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`3`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` https://api.notion.com/admin/v1/legal_holds`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`-H `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Authorization: Bearer adm_t1CdN9S8yicG5eWLUOfhcWaOscVnFXnsJM9cWeCdTNfhbt\"`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`-H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Notion-Version: 2026-06-01\"`})]}),`\n`]})})}),`\n`,_jsxs(Warning,{children:[_jsx(_components.p,{children:_jsx(_components.strong,{children:`Required Header`})}),_jsxs(_components.p,{children:[`The `,_jsx(_components.code,{children:`Notion-Version`}),` header must be included in all REST API requests. This ensures the Notion API response is consistent with what your code expects.`]}),_jsxs(_components.p,{children:[`The most recent `,_jsx(_components.code,{children:`Notion-Version`}),` is `,latestAdminApiVersion,`.`]})]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{latestAdminApiVersion,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":{"title":"Versioning","description":"Learn about API change management and how to set the appropriate version in your connection.","href":"/reference/admin/versioning"}}},"mdxSourceWithNoJs":null,"noJsSplices":[[156,203,"undefined;function _"],[677,699,""],[2684,2706,""]]},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":["/_mintlify/custom/notion-demo/f3af24179eebc764/mcp-section-label.js","/_mintlify/custom/notion-demo/96b92b5a9cb7e11c/mcp-tool-section-redirects.js"],"subdomain":"notion-demo","siteName":"Notion Docs","title":"Versioning - Notion Docs","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-05-29T16:52:32.778Z","originalFileLocation":"reference/admin/versioning.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=\"description\" content=\"Learn about API change management and how to set the appropriate version in your connection.\">\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=\"Versioning - Notion Docs\">\u003cmeta data-mint-head property=\"og:description\" content=\"Learn about API change management and how to set the appropriate version in your connection.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Notion Docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://developers.notion.com/reference/admin/versioning\">\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=\"Versioning - Notion Docs\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Learn about API change management and how to set the appropriate version in your connection.\">\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/admin/versioning\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/reference/admin/versioning.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/admin/versioning#webpage\",\"url\":\"https://developers.notion.com/reference/admin/versioning\",\"name\":\"Versioning\",\"description\":\"Learn about API change management and how to set the appropriate version in your connection.\",\"dateModified\":\"2026-05-29T16:52:32.778Z\",\"isPartOf\":{\"@id\":\"https://developers.notion.com#website\"},\"breadcrumb\":{\"@id\":\"https://developers.notion.com/reference/admin/versioning#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://developers.notion.com/reference/admin/versioning#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Admin API\",\"item\":\"https://developers.notion.com/reference/admin/intro\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Versioning\",\"item\":\"https://developers.notion.com/reference/admin/versioning\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://developers.notion.com/reference/admin/versioning#article\",\"headline\":\"Versioning\",\"name\":\"Versioning\",\"description\":\"Learn about API change management and how to set the appropriate version in your connection.\",\"url\":\"https://developers.notion.com/reference/admin/versioning\",\"mainEntityOfPage\":{\"@id\":\"https://developers.notion.com/reference/admin/versioning#webpage\"},\"image\":\"https://developers.notion.com/images/og-image.png\",\"dateModified\":\"2026-05-29T16:52:32.778Z\",\"publisher\":{\"@id\":\"https://developers.notion.com/#organization\"},\"isPartOf\":{\"@id\":\"https://developers.notion.com#website\"}}]}\u003c/script>","agentPointerHref":"/reference/admin/versioning.md","siteName":"Notion Docs","nav":{"global":{"anchors":[]},"tabs":[{"tab":"Guides","pages":[{"title":"Guides","href":"/guides/notion-api/quick-start"}]},{"tab":"API Reference","pages":[{"title":"API Reference","href":"/reference/intro"}]},{"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,"groups":[{"group":"Admin API","pages":[{"title":"Introduction","href":"/reference/admin/intro"},{"title":"Scopes","description":"Admin API scopes control an organization bot token's access.","href":"/reference/admin/scopes"},{"title":"Versioning","href":"/reference/admin/versioning"}]},{"group":"Endpoints","pages":[{"group":"Legal holds","pages":[{"openapi":"openapi-adminApi.json GET /v1/legal_holds","description":"List all legal holds belonging to your organization.","title":"List legal holds","href":"/reference/admin/list-legal-holds"},{"openapi":"openapi-adminApi.json POST /v1/legal_holds/{legal_hold_id}/users","title":"Add users to a legal hold","href":"/reference/admin/add-legal-hold-users"},{"openapi":"openapi-adminApi.json POST /v1/legal_holds","title":"Create a legal hold","href":"/reference/admin/create-legal-hold"},{"openapi":"openapi-adminApi.json POST /v1/legal_holds/{legal_hold_id}/export","title":"Export a legal hold","href":"/reference/admin/export-legal-hold"},{"openapi":"openapi-adminApi.json GET /v1/legal_holds/{legal_hold_id}","title":"Retrieve a legal hold","href":"/reference/admin/get-legal-hold"},{"openapi":"openapi-adminApi.json GET /v1/legal_holds/{legal_hold_id}/spaces/{space_id}/pages","title":"List pages on a legal hold","href":"/reference/admin/list-legal-hold-pages"},{"openapi":"openapi-adminApi.json GET /v1/legal_holds/{legal_hold_id}/users","title":"List users on a legal hold","href":"/reference/admin/list-legal-hold-users"},{"openapi":"openapi-adminApi.json GET /v1/legal_holds/{legal_hold_id}/workspaces","title":"List workspaces on a legal hold","href":"/reference/admin/list-legal-hold-workspaces"},{"openapi":"openapi-adminApi.json POST /v1/legal_holds/{legal_hold_id}/release","title":"Release a legal hold","href":"/reference/admin/release-legal-hold"},{"openapi":"openapi-adminApi.json DELETE /v1/legal_holds/{legal_hold_id}/users/{user_id}","title":"Remove a user from a legal hold","href":"/reference/admin/remove-legal-hold-user"},{"openapi":"openapi-adminApi.json PATCH /v1/legal_holds/{legal_hold_id}","title":"Update a legal hold","href":"/reference/admin/update-legal-hold"}]},{"group":"Managed users","pages":[{"openapi":"openapi-adminApi.json POST /v1/managed_users/revoke_session","title":"Revoke a managed user's sessions","href":"/reference/admin/revoke-user-session"}]},{"group":"Users","pages":[{"openapi":"openapi-adminApi.json GET /v1/spaces/{space_id}/users","sidebarTitle":"List users","title":"List users","href":"/reference/admin/list-users"},{"openapi":"openapi-adminApi.json GET /v1/spaces/{space_id}/users/credit_usage","title":"Get credit usage for users in a space","href":"/reference/admin/list-user-credit-usage"},{"openapi":"openapi-adminApi.json GET /v1/spaces/{space_id}/users/{user_id}/credit_usage","title":"Get credit usage for a user in a space","href":"/reference/admin/list-user-credit-usage-periods"}]},{"group":"Permission groups","pages":[{"openapi":"openapi-adminApi.json GET /v1/spaces/{space_id}/groups","sidebarTitle":"List groups","title":"List groups","href":"/reference/admin/list-permission-groups"},{"openapi":"openapi-adminApi.json GET /v1/spaces/{space_id}/groups/{group_id}","sidebarTitle":"Retrieve a group","title":"Retrieve a group","href":"/reference/admin/retrieve-permission-group"},{"openapi":"openapi-adminApi.json POST /v1/spaces/{space_id}/groups","sidebarTitle":"Create a group","title":"Create a group","href":"/reference/admin/create-permission-group"},{"openapi":"openapi-adminApi.json PATCH /v1/spaces/{space_id}/groups/{group_id}","sidebarTitle":"Update a group","title":"Update a group","href":"/reference/admin/update-permission-group"},{"openapi":"openapi-adminApi.json DELETE /v1/spaces/{space_id}/groups/{group_id}","sidebarTitle":"Delete a group","title":"Delete a group","href":"/reference/admin/delete-permission-group"},{"openapi":"openapi-adminApi.json GET /v1/spaces/{space_id}/groups/{group_id}/members","sidebarTitle":"List members","title":"List group members","href":"/reference/admin/list-permission-group-members"},{"openapi":"openapi-adminApi.json POST /v1/spaces/{space_id}/groups/{group_id}/members","sidebarTitle":"Add a member","title":"Add a group member","href":"/reference/admin/add-permission-group-member"},{"openapi":"openapi-adminApi.json PATCH /v1/spaces/{space_id}/groups/{group_id}/members/users/{user_id}","sidebarTitle":"Update a member","title":"Update a group member","href":"/reference/admin/update-permission-group-member"},{"openapi":"openapi-adminApi.json DELETE /v1/spaces/{space_id}/groups/{group_id}/members/users/{user_id}","sidebarTitle":"Remove a member","title":"Remove a group member","href":"/reference/admin/remove-permission-group-member"}]},{"group":"Agents","pages":[{"openapi":"openapi-adminApi.json GET /v1/spaces/{space_id}/agents","title":"Get agents in a space","href":"/reference/admin/get-workflows-metadata-for-space"},{"openapi":"openapi-adminApi.json GET /v1/spaces/{space_id}/agents/{agent_id}/credit_usage","title":"Get credit usage for an agent in a space","href":"/reference/admin/get-agent-credit-usage"},{"openapi":"openapi-adminApi.json GET /v1/spaces/{space_id}/agents/credit_usage","title":"Get credit usage for agents in a space","href":"/reference/admin/get-agents-credit-usage"},{"openapi":"openapi-adminApi.json PATCH /v1/spaces/{space_id}/agents/{agent_id}","title":"Update an agent in a space","href":"/reference/admin/update-agent"},{"openapi":"openapi-adminApi.json PUT /v1/spaces/{space_id}/agents/{agent_id}/credit_limit","title":"Update credit limit for an agent in a space","href":"/reference/admin/update-agent-credit-limit"},{"openapi":"openapi-adminApi.json GET /v1/spaces/{space_id}/agents/{agent_id}/permissions","title":"Get a custom agent's sharing permissions","href":"/reference/admin/get-agent-permissions"},{"openapi":"openapi-adminApi.json PATCH /v1/spaces/{space_id}/agents/{agent_id}/permissions","title":"Update a custom agent's sharing permissions","href":"/reference/admin/update-agent-permissions"},{"openapi":"openapi-adminApi.json DELETE /v1/spaces/{space_id}/agents/{agent_id}","title":"Delete an agent in a space","href":"/reference/admin/delete-agent"},{"openapi":"openapi-adminApi.json PATCH /v1/spaces/{space_id}/agents/{agent_id}/status","title":"Disable or re-enable an agent in a space","href":"/reference/admin/update-agent-status"},{"openapi":"openapi-adminApi.json PATCH /v1/spaces/{space_id}/agents/creation_policy","title":"Update who can create agents in a space","href":"/reference/admin/update-agent-creation-policy"},{"openapi":"openapi-adminApi.json PATCH /v1/spaces/{space_id}/credit_limit","hidden":true,"title":"Update the default agent credit limit for a workspace","href":"/reference/admin/update-workspace-credit-limit"}]},{"group":"Credit access policies","pages":[{"openapi":"openapi-adminApi.json GET /v1/spaces/{space_id}/policies/credit_access","title":"List credit access policies","href":"/reference/admin/list-credit-access-policies"},{"openapi":"openapi-adminApi.json GET /v1/spaces/{space_id}/policies/credit_access/{policy_id}","title":"Get credit access policy","href":"/reference/admin/get-credit-access-policy"},{"openapi":"openapi-adminApi.json POST /v1/spaces/{space_id}/policies/credit_access","title":"Create credit access policy","href":"/reference/admin/create-credit-access-policy"},{"openapi":"openapi-adminApi.json PATCH /v1/spaces/{space_id}/policies/credit_access/{policy_id}","title":"Update credit access policy","href":"/reference/admin/update-credit-access-policy"},{"openapi":"openapi-adminApi.json DELETE /v1/spaces/{space_id}/policies/credit_access/{policy_id}","title":"Delete credit access policy","href":"/reference/admin/delete-credit-access-policy"},{"openapi":"openapi-adminApi.json GET /v1/spaces/{space_id}/policies/credit_access/{policy_id}/assignments","title":"List credit access assignments","href":"/reference/admin/list-credit-access-assignments"},{"openapi":"openapi-adminApi.json GET /v1/spaces/{space_id}/policies/credit_access/assignments/{assignment_id}","title":"Get credit access assignment","href":"/reference/admin/get-credit-access-assignment"},{"openapi":"openapi-adminApi.json POST /v1/spaces/{space_id}/policies/credit_access/{policy_id}/assignments","title":"Create credit access assignment","href":"/reference/admin/create-credit-access-assignment"},{"openapi":"openapi-adminApi.json PATCH /v1/spaces/{space_id}/policies/credit_access/assignments/{assignment_id}","title":"Update credit access assignment","href":"/reference/admin/update-credit-access-assignment"},{"openapi":"openapi-adminApi.json DELETE /v1/spaces/{space_id}/policies/credit_access/assignments/{assignment_id}","title":"Delete credit access assignment","href":"/reference/admin/delete-credit-access-assignment"}]},{"group":"MCP client connections","pages":[{"openapi":"openapi-adminApi.json GET /v1/mcp_client_connections","sidebarTitle":"List connections","title":"List MCP client connections in an organization","href":"/reference/admin/list-mcp-client-connections"},{"openapi":"openapi-adminApi.json POST /v1/mcp_client_connections/revoke","sidebarTitle":"Revoke a connection","title":"Revoke an MCP client connection","href":"/reference/admin/revoke-mcp-client-connection"},{"openapi":"openapi-adminApi.json PUT /v1/mcp_client_connections/enterprise_managed_access","sidebarTitle":"Manage enterprise access","title":"Deny or restore enterprise-managed MCP client access","href":"/reference/admin/update-mcp-client-connection-enterprise-managed-access"}]},{"group":"Personal access tokens","pages":[{"openapi":"openapi-adminApi.json GET /v1/spaces/{space_id}/personal_access_tokens","sidebarTitle":"List tokens","title":"List personal access tokens in a workspace","href":"/reference/admin/list-personal-access-tokens"},{"openapi":"openapi-adminApi.json DELETE /v1/spaces/{space_id}/personal_access_tokens/{bot_id}","sidebarTitle":"Revoke a token","title":"Revoke a personal access token in a workspace","href":"/reference/admin/revoke-personal-access-token"}]},{"group":"Workspaces","pages":[{"openapi":"openapi-adminApi.json GET /v1/spaces","sidebarTitle":"List workspaces","title":"List workspaces in the organization","href":"/reference/admin/list-spaces"},{"openapi":"openapi-adminApi.json POST /v1/spaces/{space_id}/exports","title":"Enqueue a workspace export","href":"/reference/admin/enqueue-space-export"},{"openapi":"openapi-adminApi.json GET /v1/spaces/{space_id}/exports/{export_job_id}","title":"Get workspace export status","href":"/reference/admin/get-space-export-status"}]}]}]},{"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":"Versioning - Notion Docs","deploymentId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","buildId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","dynamics":[],"chunks":[]}