How Voyado Elevate versions the Admin and Storefront APIs and manages release lifecycles
API versioning enables continuous usage enhancements and capability advancements, while offering integrators a predictable path for feature upgrades and deprecations.
New versions of either API are targeted to be released at most twice a year. The version number is incremented with each release and is communicated in the changelog as well as the API overview upon release.
Upon release of a new version, the previous version of that API will enter Active LTS. LTS, “long-term support,” typically guarantees that critical bugs will be fixed and lasts for 18 months. When a version enters Active LTS, the End of life date will be declared.
To focus efforts on more and improved capabilities, versions that have reached End of life will no longer be supported. Removal of support will always be rolled out in a controlled and safe manner, ensuring awareness of potential usage and timelines.
Last modified on October 28, 2026
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Product Discovery developer docs","description":"Product Discovery developer docs","colors":{"primary":"#fe4a49","light":"#ff8785","dark":"#4c093e"},"logo":{"light":"https://mintcdn.com/elevatedocs/1uBQSi2ovHREOrJm/assets/logo/voyado-light-logo.svg?fit=max\u0026auto=format\u0026n=1uBQSi2ovHREOrJm\u0026q=85\u0026s=6ab6674fd4ef6d98e2e482644482eaf8","dark":"https://mintcdn.com/elevatedocs/1uBQSi2ovHREOrJm/assets/logo/voyado-dark-logo.svg?fit=max\u0026auto=format\u0026n=1uBQSi2ovHREOrJm\u0026q=85\u0026s=ce9a169f8b3235ef225c95f50b3e3853","href":"/docs/home/about"},"favicon":"https://mintcdn.com/elevatedocs/U2rlNuBdHmV1mTwc/assets/logo/favicon-bw-32x32.png?fit=max\u0026auto=format\u0026n=U2rlNuBdHmV1mTwc\u0026q=85\u0026s=5b0c7f8a7b5c7f1c304eacf65bc6b39d","api":{"playground":{"display":"interactive"},"examples":{"defaults":"all","languages":["curl","javascript","java","csharp","python"],"prefill":true}},"appearance":{"default":"light"},"background":{"color":{"light":"#ffffff","dark":"#1e2129"}},"navbar":{"links":[{"icon":"/assets/icons/help-center-link.png","href":"https://help.elevate.voyado.com/hc/en-gb","label":"Help Center"}],"primary":{"type":"button","label":"Contact us","href":"https://voyado.com/about-voyado/contact-us/"}},"seo":{"metatags":{"og:site_name":"Product Discovery developer docs","og:type":"website"},"organization":{"id":"https://voyado.com/","legalName":"Voyado Lund AB","url":"https://voyado.com/","logo":"https://voyado.com/wp-content/uploads/2023/01/cropped-Favicon-192x192.png","sameAs":["https://www.linkedin.com/company/voyadoab/","https://www.facebook.com/voyado/","https://www.instagram.com/voyado_official/"]},"indexing":"navigable"},"fonts":{"heading":{"family":"Voyado Text","source":"https://mintlify-assets.b-cdn.net/VoyadoText-Medium.woff2","format":"woff2"},"body":{"family":"Voyado Regular","source":"https://mintlify-assets.b-cdn.net/VoyadoText-Regular.woff2","format":"woff2"}},"styling":{"eyebrows":"breadcrumbs","latex":false},"integrations":{"cookies":{"key":"mintlify_telemetry","value":"granted"}},"contextual":{"options":["claude","chatgpt","assistant","copy","view","mcp"],"display":"header"},"metadata":{"timestamp":true},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"elevatedocs","hasAudioNarration":false,"actualSubdomain":"elevatedocs","customDomains":["product-discovery.developer.voyado.com"],"gitSource":{"type":"github","owner":"voyado","repo":"elevate-docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"chroma":{"latestBuiltDeploymentHistoryId":"6ae1b640661bff0c6e7268b7","collectionId":"6995d297-6474-4fdf-99f9-16c317ed200c","liveDeploymentHistoryId":"6ae1b640661bff0c6e7268b7","schemaVersion":"v3"},"feedback":{"thumbs":false,"agentFeedback":false},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6ae1b640661bff0c6e7268b7","clientVersion":"0.0.4044","searchFilterCounts":[{"language":"default","tag":"API","count":69},{"language":"default","tag":"Admin","count":42},{"language":"default","tag":"v3","count":39},{"language":"default","tag":"Guides","count":24},{"language":"default","tag":"v4","count":23},{"language":"default","tag":"Integration","count":23},{"language":"default","tag":"Storefront","count":22},{"language":"default","tag":"Add-ons","count":12},{"language":"default","tag":"Export","count":12},{"language":"default","tag":"Import","count":12}],"searchSettings":{"maxResults":8,"showContentSnippets":false,"isFiltersEnabled":false}},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":true,"enableContextualStarterQuestions":true,"enableAskAiSearchBar":true,"deflection":{"enabled":true,"type":"link","url":"https://voyado.com/about-voyado/contact-us/"}},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","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":"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":"llms-txt-v2","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":"byok-sep-25","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":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-updated-9-15","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":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"privacy":{"consentBanner":{"enabled":false}},"googleFontsInlined":false},"customCss":[{"filePath":"styles/style.css","content":".border-b{border-bottom-width:2px;border-color:rgb(var(--gray-200))}html.dark .border-b,html.dark .prose pre{border-color:rgba(255,255,255,.18)}.prose-sm{font-size:.9rem;line-height:1.7}html.dark{--gray-50:222 227 234;--gray-100:213 218 226;--gray-200:197 203 213;--gray-300:176 183 194;--gray-400:145 152 164}html.dark .prose{--tw-prose-body:#b3b9c4;--tw-prose-headings:#d2d7e0;--tw-prose-lead:#a7aeba;--tw-prose-links:#c5cbd5;--tw-prose-bold:#dde2ea;--tw-prose-counters:#8d95a2;--tw-prose-bullets:#626a78;--tw-prose-hr:#363c47;--tw-prose-quotes:#cdd3dc;--tw-prose-quote-borders:#454c58;--tw-prose-captions:#8d95a2;--tw-prose-code:#cdd3dc;--tw-prose-pre-code:#cdd3dc;--tw-prose-th-borders:#5c6474;--tw-prose-td-borders:#4a5162}.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-code);font-weight:500;background-color:#f8f8f7;border:1px solid #c7dbe8;border-radius:4px;padding-left:.25em;padding-right:.25em}html.dark .prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)){color:#cdd3dc;background-color:#272c36;border-color:#3a404b}.prose pre code{background-color:transparent!important;border:0!important;color:inherit!important;font-weight:400;padding-left:0!important}.py-1\\.5{padding-top:1px;padding-bottom:1px}@media (min-width:1024px){.lg\\:mt-8{margin-top:1rem}}html.dark #navigation-items a[aria-current=page]{background-color:rgb(var(--primary)/.14);color:#ff8785}html.dark #navigation-items a[aria-current=page] *{color:inherit}html.dark .code-block.dark\\:bg-white\\/5,html.dark .dark\\:bg-codeblock{background-color:#1e2129}html.dark .dark\\:bg-codeblock\\/50{background-color:rgb(30 33 41/.5)}html.dark .prose table thead tr,html.dark [data-component-part=code-block-header]{background-color:rgba(255,255,255,.06)}html.dark .code-block-background,html.dark [data-fade-overlay],html.dark pre.shiki{--shiki-dark-bg:#1e2129!important;--fade-color-dark:#1e2129!important}.sidebar-title{margin-bottom:-.3rem;font-size:15px}#pagination{display:none!important}.help-center-card [data-component-part=card-icon]{width:2rem;height:2rem;flex-shrink:0;display:flex;align-items:center;justify-content:center}.help-center-card [data-component-part=card-icon] img{width:2rem;height:2rem;object-fit:contain}#topbar-cta-button a>span:first-child{background-color:rgb(var(--primary)/.1);border:1px solid rgb(var(--primary)/.25)}html.dark #topbar-cta-button a>span:first-child{background-color:rgb(var(--primary)/.14);border-color:rgb(var(--primary)/.3)}#topbar-cta-button a:hover>span:first-child{background-color:rgb(var(--primary)/.18);opacity:1}html.dark #topbar-cta-button a:hover>span:first-child{background-color:rgb(var(--primary)/.22)}#topbar-cta-button a span,#topbar-cta-button a svg,#topbar-cta-button a>div{color:rgb(var(--primary))}html.dark #topbar-cta-button a span,html.dark #topbar-cta-button a svg,html.dark #topbar-cta-button a>div{color:#ff8785}.prose table{border-collapse:collapse;width:100%;max-width:100%;table-layout:auto}.prose table td,.prose table th{border:0;padding:.4rem .5rem;white-space:normal;overflow-wrap:anywhere;word-break:break-word}.accordion [data-table-wrapper=true],[data-component-part=accordion-content] [data-table-wrapper=true]{--page-padding:0px;max-width:100%}.prose table thead tr{background-color:rgba(0,0,0,.05)}html.dark .prose table thead{border-color:#4b5261}html.dark .prose table tr{border-color:#3b4250}.prose table thead th{font-weight:600}.prose table tbody td{background-color:#fff}html.dark .prose table tbody td{background-color:transparent}.prose :where(h2):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.6em;margin-bottom:.7em}.prose :where(h3):not(:where([class~=not-prose],[class~=not-prose] *)),.prose :where(h4):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.5em;margin-bottom:.6em}#mobile-nav [data-elevate-tab-dropdown]{display:none}#mobile-nav [data-elevate-tab-list]{padding-bottom:.75rem;border-bottom:1px solid rgb(var(--gray-200)/.7)}html.dark #mobile-nav [data-elevate-tab-list]{border-bottom-color:rgb(255 255 255/.07)}#mobile-nav [data-elevate-tab-list] ul{display:flex;flex-direction:column;gap:.125rem;margin:0;padding:0;list-style:none}#mobile-nav [data-elevate-tab-list] a{display:block;padding:.375rem .75rem .375rem 1rem;border-radius:.75rem;font-size:1rem;font-weight:500;line-height:1.5rem;color:rgb(var(--gray-700));text-decoration:none}html.dark #mobile-nav [data-elevate-tab-list] a{color:rgb(var(--gray-300))}#mobile-nav [data-elevate-tab-list] a:hover{background-color:rgb(var(--gray-600)/.05)}html.dark #mobile-nav [data-elevate-tab-list] a:hover{background-color:rgb(var(--gray-200)/.05)}#mobile-nav [data-elevate-tab-list] a[data-active]{background-color:rgb(var(--primary)/.1);color:rgb(var(--primary))}html.dark #mobile-nav [data-elevate-tab-list] a[data-active]{background-color:rgb(var(--primary-light)/.1);color:rgb(var(--primary-light))}"}],"page":{"pagePath":"docs/api/api-versioning","slug":"/docs/api/api-versioning","pageMetadata":{"title":"API versioning","description":"How Voyado Elevate versions the Admin and Storefront APIs and manages release lifecycles","href":"/docs/api/api-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: \"How Voyado Elevate versions the Admin and Storefront APIs and manages release lifecycles\"\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];function _createMdxContent(props){const _components={a:`a`,code:`code`,li:`li`,p:`p`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,ul:`ul`,..._provideComponents(),...props.components},{Heading,Icon,Table,Tip}=_components;if(!Heading)_missingMdxReference(`Heading`,true);if(!Icon)_missingMdxReference(`Icon`,true);if(!Table)_missingMdxReference(`Table`,true);if(!Tip)_missingMdxReference(`Tip`,true);return _jsxs(_Fragment,{children:[_jsx(_components.p,{children:`API versioning enables continuous usage enhancements and capability advancements, while offering integrators a predictable path for feature upgrades and deprecations.`}),`\n`,_jsx(Heading,{level:`2`,id:`version-overview`,children:`Version overview`}),`\n`,_jsx(_components.p,{children:`The current release status of each version of the APIs.`}),`\n`,_jsx(Heading,{level:`3`,id:`admin-api`,children:`Admin API`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Version`}),_jsx(_components.th,{children:`Status`}),_jsx(_components.th,{children:`Release date`}),_jsx(_components.th,{children:`End of life`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.a,{href:`/docs/api/admin/v4/overview`,children:`v4`})}),_jsxs(_components.td,{children:[_jsx(Icon,{icon:`circle-check`,color:`#16a34a`,size:14}),` `,_jsx(_components.a,{href:`#current`,children:`Current`})]}),_jsx(_components.td,{\"data-numeric\":`true`,children:`2024-10-25`}),_jsx(_components.td,{children:`N/A`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.a,{href:`/docs/api/admin/v3/overview`,children:`v3`})}),_jsxs(_components.td,{children:[_jsx(Icon,{icon:`circle-half-stroke`,color:`#d97706`,size:14}),` `,_jsx(_components.a,{href:`#active-lts`,children:`Active LTS`})]}),_jsx(_components.td,{\"data-numeric\":`true`,children:`2022-10-20`}),_jsx(_components.td,{\"data-numeric\":`true`,children:`2026-12-31`})]})]})]}),`\n`,_jsx(Heading,{level:`3`,id:`storefront-api`,children:`Storefront API`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Version`}),_jsx(_components.th,{children:`Status`}),_jsx(_components.th,{children:`Release date`}),_jsx(_components.th,{children:`End of life`})]})}),_jsx(_components.tbody,{children:_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.a,{href:`/docs/api/storefront/v3/overview`,children:`v3`})}),_jsxs(_components.td,{children:[_jsx(Icon,{icon:`circle-check`,color:`#16a34a`,size:14}),` `,_jsx(_components.a,{href:`#current`,children:`Current`})]}),_jsx(_components.td,{\"data-numeric\":`true`,children:`2022-10-20`}),_jsx(_components.td,{children:`N/A`})]})})]}),`\n`,_jsx(Heading,{level:`2`,id:`available-apis`,children:`Available APIs`}),`\n`,_jsx(_components.p,{children:`Voyado Elevate has two APIs that are versioned independently.`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`New versions of either API can be released separately`}),`\n`,_jsxs(_components.li,{children:[`Any version of the `,_jsx(_components.a,{href:`/docs/api/admin/overview`,children:`Admin API`}),` can be used with any version of the `,_jsx(_components.a,{href:`/docs/api/storefront/overview`,children:`Storefront API`})]}),`\n`,_jsx(_components.li,{children:`Breaking changes are always released as new versions`}),`\n`,_jsx(_components.li,{children:`Non-breaking changes are automatically applied to the latest version`}),`\n`]}),`\n`,_jsx(Heading,{level:`3`,id:`api-structure`,children:`API structure`}),`\n`,_jsxs(_components.p,{children:[`The path pattern of the APIs is as follows: `,_jsx(_components.code,{children:`/api/{api-name}/v{major}/{resource}`}),`, for example:`]}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:_jsx(_components.code,{children:`/api/storefront/v3/queries/search-page`})}),`\n`,_jsx(_components.li,{children:_jsx(_components.code,{children:`/api/admin/v4/status`})}),`\n`]}),`\n`,_jsx(Tip,{children:_jsx(_components.p,{children:`The path for all resources within each API is affected by a new API release. Structure the integration accordingly to facilitate upgrades.`})}),`\n`,_jsx(Heading,{level:`2`,id:`release-cadence`,children:`Release cadence`}),`\n`,_jsx(_components.p,{children:`New versions of either API are targeted to be released at most twice a year. The version number is incremented with each release and is communicated in the changelog as well as the API overview upon release.`}),`\n`,_jsx(Heading,{level:`3`,id:`release-status`,children:`Release status`}),`\n`,_jsxs(_components.p,{children:[`An API version will have one of three release statuses: `,_jsx(_components.code,{children:`Current`}),`, `,_jsx(_components.code,{children:`Active LTS`}),`, or `,_jsx(_components.code,{children:`End of life`}),`.`]}),`\n`,_jsx(Heading,{level:`4`,id:`current`,children:`Current`}),`\n`,_jsxs(_components.p,{children:[`A newly released version of an API is given the release status `,_jsx(_components.code,{children:`Current`}),`. This status will be kept until a new version of the API is released.`]}),`\n`,_jsx(Heading,{level:`4`,id:`active-lts`,children:`Active LTS`}),`\n`,_jsxs(_components.p,{children:[`Upon release of a new version, the previous version of that API will enter `,_jsx(_components.code,{children:`Active LTS`}),`. LTS, “long-term support,” typically guarantees that critical bugs will be fixed and lasts for 18 months. When a version enters `,_jsx(_components.code,{children:`Active LTS`}),`, the `,_jsx(_components.code,{children:`End of life`}),` date will be declared.`]}),`\n`,_jsx(Heading,{level:`4`,id:`end-of-life`,children:`End of life`}),`\n`,_jsxs(_components.p,{children:[`To focus efforts on more and improved capabilities, versions that have reached `,_jsx(_components.code,{children:`End of life`}),` will no longer be supported. Removal of support will always be rolled out in a controlled and safe manner, ensuring awareness of potential usage and timelines.`]})]})}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":{"title":"API versioning","description":"How Voyado Elevate versions the Admin and Storefront APIs and manages release lifecycles","href":"/docs/api/api-versioning"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Version overview","slug":"version-overview","depth":2,"children":[{"title":"Admin API","slug":"admin-api","depth":3,"children":[]},{"title":"Storefront API","slug":"storefront-api","depth":3,"children":[]}]},{"title":"Available APIs","slug":"available-apis","depth":2,"children":[{"title":"API structure","slug":"api-structure","depth":3,"children":[]}]},{"title":"Release cadence","slug":"release-cadence","depth":2,"children":[{"title":"Release status","slug":"release-status","depth":3,"children":[]},{"title":"Current","slug":"current","depth":4,"children":[]},{"title":"Active LTS","slug":"active-lts","depth":4,"children":[]},{"title":"End of life","slug":"end-of-life","depth":4,"children":[]}]}],"codeExamples":{}},"jsLinks":["/_mintlify/custom/elevatedocs/e981000376caad84/scripts/disable-accordion-link-copy.js","/_mintlify/custom/elevatedocs/9f72db540c8d3f36/scripts/mobile-nav-tab-list.js","/_mintlify/custom/elevatedocs/3c15ab69a2191b51/scripts/gtm.js"],"subdomain":"elevatedocs","siteName":"Product Discovery developer docs","title":"API versioning - Product Discovery developer docs","relatedPagesConfig":{"enabled":false,"limit":5,"mode":"automatic"},"contextualStarterQuestions":[{"_id":"6aaba4351420944c888a0959","deploymentId":"6a638c2b4251baa99ac33cca","questionText":"When does API v3 end of life?","status":"active","generatedBy":"contextual","path":"docs/api/api-versioning","createdAt":"2026-09-17T08:26:29.822Z","updatedAt":"2026-09-17T08:26:29.822Z","__v":0},{"_id":"6aaba4351420944c888a095a","deploymentId":"6a638c2b4251baa99ac33cca","questionText":"How are API versions structured?","status":"active","generatedBy":"contextual","path":"docs/api/api-versioning","createdAt":"2026-09-17T08:26:29.822Z","updatedAt":"2026-09-17T08:26:29.822Z","__v":0},{"_id":"6aaba4351420944c888a0958","deploymentId":"6a638c2b4251baa99ac33cca","questionText":"What is the current Admin API version?","status":"active","generatedBy":"contextual","path":"docs/api/api-versioning","createdAt":"2026-09-17T08:26:29.822Z","updatedAt":"2026-09-17T08:26:29.822Z","__v":0}],"navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-09-17T08:26:01.791Z","gitLastModified":"2026-10-28T07:26:27.000Z","originalFileLocation":"docs/api/api-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=\"light\"}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=\"How Voyado Elevate versions the Admin and Storefront APIs and manages release lifecycles\">\u003cmeta data-mint-head name=\"application-name\" content=\"Product Discovery developer 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/elevatedocs/pFLF7Ck4WVv5gLWu/_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/elevatedocs/pFLF7Ck4WVv5gLWu/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/elevatedocs/pFLF7Ck4WVv5gLWu/_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/elevatedocs/pFLF7Ck4WVv5gLWu/_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/elevatedocs/pFLF7Ck4WVv5gLWu/_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/elevatedocs/pFLF7Ck4WVv5gLWu/_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/elevatedocs/pFLF7Ck4WVv5gLWu/_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/elevatedocs/pFLF7Ck4WVv5gLWu/_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/elevatedocs/pFLF7Ck4WVv5gLWu/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"API versioning - Product Discovery developer docs\">\u003cmeta data-mint-head property=\"og:description\" content=\"How Voyado Elevate versions the Admin and Storefront APIs and manages release lifecycles\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Product Discovery developer docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://product-discovery.developer.voyado.com/docs/api/api-versioning\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://elevatedocs.mintlify.app/_mintlify/api/og/v2?division=Overview\u0026amp;title=API+versioning\u0026amp;description=How+Voyado+Elevate+versions+the+Admin+and+Storefront+APIs+and+manages+release+lifecycles\u0026amp;theme=f58243c8184ccc363977f3a7\u0026amp;signature=87885d3e1252940e210f626399277130c89d50bfdb2b6d40282b87571e88d61b\">\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=\"API versioning - Product Discovery developer docs\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"How Voyado Elevate versions the Admin and Storefront APIs and manages release lifecycles\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://elevatedocs.mintlify.app/_mintlify/api/og/v2?division=Overview\u0026amp;title=API+versioning\u0026amp;description=How+Voyado+Elevate+versions+the+Admin+and+Storefront+APIs+and+manages+release+lifecycles\u0026amp;theme=f58243c8184ccc363977f3a7\u0026amp;signature=87885d3e1252940e210f626399277130c89d50bfdb2b6d40282b87571e88d61b\">\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/elevatedocs/pFLF7Ck4WVv5gLWu/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Product Discovery developer docs\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#fe4a49\">\u003clink data-mint-head rel=\"canonical\" href=\"https://product-discovery.developer.voyado.com/docs/api/api-versioning\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/docs/api/api-versioning.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://voyado.com/\",\"name\":\"Product Discovery developer docs\",\"legalName\":\"Voyado Lund AB\",\"url\":\"https://voyado.com/\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://voyado.com/wp-content/uploads/2023/01/cropped-Favicon-192x192.png\"},\"sameAs\":[\"https://www.linkedin.com/company/voyadoab/\",\"https://www.facebook.com/voyado/\",\"https://www.instagram.com/voyado_official/\"]},{\"@type\":\"WebSite\",\"@id\":\"https://product-discovery.developer.voyado.com#website\",\"name\":\"Product Discovery developer docs\",\"url\":\"https://product-discovery.developer.voyado.com\",\"publisher\":{\"@id\":\"https://voyado.com/\"}},{\"@type\":\"WebPage\",\"@id\":\"https://product-discovery.developer.voyado.com/docs/api/api-versioning#webpage\",\"url\":\"https://product-discovery.developer.voyado.com/docs/api/api-versioning\",\"name\":\"API versioning\",\"description\":\"How Voyado Elevate versions the Admin and Storefront APIs and manages release lifecycles\",\"dateModified\":\"2026-10-28T07:26:27.000Z\",\"isPartOf\":{\"@id\":\"https://product-discovery.developer.voyado.com#website\"},\"breadcrumb\":{\"@id\":\"https://product-discovery.developer.voyado.com/docs/api/api-versioning#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://product-discovery.developer.voyado.com/docs/api/api-versioning#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Overview\",\"item\":\"https://product-discovery.developer.voyado.com/docs/api/getting-started\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"API versioning\",\"item\":\"https://product-discovery.developer.voyado.com/docs/api/api-versioning\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://product-discovery.developer.voyado.com/docs/api/api-versioning#article\",\"headline\":\"API versioning\",\"name\":\"API versioning\",\"description\":\"How Voyado Elevate versions the Admin and Storefront APIs and manages release lifecycles\",\"url\":\"https://product-discovery.developer.voyado.com/docs/api/api-versioning\",\"mainEntityOfPage\":{\"@id\":\"https://product-discovery.developer.voyado.com/docs/api/api-versioning#webpage\"},\"dateModified\":\"2026-10-28T07:26:27.000Z\",\"publisher\":{\"@id\":\"https://voyado.com/\"},\"isPartOf\":{\"@id\":\"https://product-discovery.developer.voyado.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Product Discovery developer docs\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Product Discovery developer docs","nav":{"global":null,"tabs":[{"tab":"Home","pages":[{"title":"Home","href":"/docs/home/about"}]},{"tab":"Integration","pages":[{"title":"Integration","href":"/docs/integration/overview"}]},{"tab":"API","groups":[{"group":"Overview","pages":[{"title":"API overview","description":"Prerequisites and best practices for integrating with the Voyado Elevate API","href":"/docs/api/getting-started"},{"title":"API versioning","href":"/docs/api/api-versioning"},{"title":"OpenAPI specifications","description":"OpenAPI specifications for Voyado Elevate","href":"/docs/api/specifications"},{"title":"Postman collections","href":"/docs/api/postman"},{"title":"JavaScript library","href":"/docs/api/javascript-library"}]},{"group":"Admin","pages":[{"title":"Overview","href":"/docs/api/admin/overview"},{"group":"v4","expanded":true,"pages":[{"title":"Overview","href":"/docs/api/admin/v4/overview"},{"title":"Catalog upgrade guide","href":"/docs/api/admin/v4/v4-upgrade"},{"group":"Event data","pages":[{"title":"Create Export Customer Job","href":"/docs/api/admin/v4/event-data/create-export-customer-job"},{"title":"Create Remove Customer Job","href":"/docs/api/admin/v4/event-data/create-remove-customer-job"},{"title":"Export Customer Job Result","href":"/docs/api/admin/v4/event-data/export-customer-job-result"},{"title":"Job Status","href":"/docs/api/admin/v4/event-data/job-status"}]},{"group":"Export","pages":[{"title":"Catalog","href":"/docs/api/admin/v4/export/catalog"},{"title":"Configuration","href":"/docs/api/admin/v4/export/configuration"},{"title":"Navigation","href":"/docs/api/admin/v4/export/navigation"},{"title":"Pages","href":"/docs/api/admin/v4/export/pages"},{"title":"Product Sets","href":"/docs/api/admin/v4/export/product-sets"},{"title":"Templates","href":"/docs/api/admin/v4/export/templates"},{"title":"Upgrade Catalog","href":"/docs/api/admin/v4/export/upgrade-catalog"}]},{"group":"Import","pages":[{"title":"Catalog","href":"/docs/api/admin/v4/import/catalog"},{"title":"Configuration","href":"/docs/api/admin/v4/import/configuration"},{"title":"Navigation","href":"/docs/api/admin/v4/import/navigation"},{"title":"Pages","href":"/docs/api/admin/v4/import/pages"},{"title":"Product Sets","href":"/docs/api/admin/v4/import/product-sets"},{"title":"Status","href":"/docs/api/admin/v4/import/status"},{"title":"Templates","href":"/docs/api/admin/v4/import/templates"}]},{"group":"Notifications","pages":[{"title":"Latest","href":"/docs/api/admin/v4/notifications/latest"},{"title":"Payment","href":"/docs/api/admin/v4/notifications/payment"}]},{"title":"Status","href":"/docs/api/admin/v4/status"}]},{"group":"v3","expanded":false,"pages":[{"title":"Overview","href":"/docs/api/admin/v3/overview"},{"group":"Event data","pages":[{"title":"Create Export Customer Job","deprecated":true,"href":"/docs/api/admin/v3/event-data/create-export-customer-job"},{"title":"Create Remove Customer Job","deprecated":true,"href":"/docs/api/admin/v3/event-data/create-remove-customer-job"},{"title":"Export Customer Job Result","deprecated":true,"href":"/docs/api/admin/v3/event-data/export-customer-job-result"},{"title":"Job Status","deprecated":true,"href":"/docs/api/admin/v3/event-data/job-status"}]},{"group":"Export","pages":[{"title":"Data","deprecated":true,"href":"/docs/api/admin/v3/export/data"},{"title":"Navigation","deprecated":true,"href":"/docs/api/admin/v3/export/navigation"},{"title":"Pages","deprecated":true,"href":"/docs/api/admin/v3/export/pages"},{"title":"Product Groups","deprecated":true,"href":"/docs/api/admin/v3/export/product-groups"},{"title":"Templates","deprecated":true,"href":"/docs/api/admin/v3/export/templates"}]},{"group":"Import","pages":[{"title":"Data","deprecated":true,"href":"/docs/api/admin/v3/import/data"},{"title":"Navigation","deprecated":true,"href":"/docs/api/admin/v3/import/navigation"},{"title":"Pages","deprecated":true,"href":"/docs/api/admin/v3/import/pages"},{"title":"Status","deprecated":true,"href":"/docs/api/admin/v3/import/status"},{"title":"Templates","deprecated":true,"href":"/docs/api/admin/v3/import/templates"}]},{"group":"Notifications","pages":[{"title":"Latest","deprecated":true,"href":"/docs/api/admin/v3/notifications/latest"},{"title":"Payment","deprecated":true,"href":"/docs/api/admin/v3/notifications/payment"}]},{"title":"Status","deprecated":true,"href":"/docs/api/admin/v3/status"}]}]},{"group":"Storefront","pages":[{"title":"Overview","href":"/docs/api/storefront/overview"},{"group":"v3","expanded":true,"pages":[{"title":"Overview","href":"/docs/api/storefront/v3/overview"},{"group":"Notifications","pages":[{"title":"Ad Impression","href":"/docs/api/storefront/v3/notifications/ad-impression"},{"title":"Add Favorite","href":"/docs/api/storefront/v3/notifications/add-favorite"},{"title":"Add To Cart","href":"/docs/api/storefront/v3/notifications/add-to-cart"},{"title":"Click","href":"/docs/api/storefront/v3/notifications/click"},{"title":"End","href":"/docs/api/storefront/v3/notifications/end"},{"title":"Remove Favorite","href":"/docs/api/storefront/v3/notifications/remove-favorite"},{"title":"Remove Recent Searches","href":"/docs/api/storefront/v3/notifications/remove-recent-searches"},{"title":"Remove Recently Viewed","href":"/docs/api/storefront/v3/notifications/remove-recently-viewed"}]},{"group":"Queries","pages":[{"title":"Add To Cart Popup","href":"/docs/api/storefront/v3/queries/add-to-cart-popup"},{"title":"Autocomplete","href":"/docs/api/storefront/v3/queries/autocomplete"},{"title":"Cart Page","href":"/docs/api/storefront/v3/queries/cart-page"},{"title":"Content Information","href":"/docs/api/storefront/v3/queries/content-information"},{"title":"Content Search Page","href":"/docs/api/storefront/v3/queries/content-search-page"},{"title":"Discovery Agent Topic","href":"/docs/api/storefront/v3/queries/discovery-agent-topic"},{"title":"Landing Page","href":"/docs/api/storefront/v3/queries/landing-page"},{"title":"Navigation Tree","href":"/docs/api/storefront/v3/queries/navigation-tree"},{"title":"Product Page","href":"/docs/api/storefront/v3/queries/product-page"},{"title":"Search Page","href":"/docs/api/storefront/v3/queries/search-page"},{"title":"Sponsored Page","href":"/docs/api/storefront/v3/queries/sponsored-page"}]},{"group":"Utilities","pages":[{"title":"Product Information","href":"/docs/api/storefront/v3/utilities/product-information"}]}]}]}]},{"tab":"Guides","pages":[{"title":"Guides","href":"/docs/guides/overview"}]},{"tab":"Add-ons","pages":[{"title":"Add-ons","href":"/docs/addons/overview"}]},{"tab":"Changelog","pages":[{"title":"Changelog","href":"/docs/changelog/changelog"}]}]},"basePath":"","title":"API versioning - Product Discovery developer docs","buildId":"dpl_DeHjVRGfFnhYQwHnfC2pjeXXv8h9","deploymentId":"dpl_DeHjVRGfFnhYQwHnfC2pjeXXv8h9","dynamics":[],"chunks":[]}