{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-developer-resources/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"API versioning"},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"api-versioning","__idx":0},"children":["API versioning"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Ingrid publishes API documentation in stable, preview, and—when needed—long-term"," ","support channels. API operations use versioned paths, and product-specific"," ","documentation exposes its available channels through a version picker."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"stable","__idx":1},"children":["Stable"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Stable APIs are suitable for production integrations. Breaking changes require"," ","a new major channel or an announced migration period."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"preview","__idx":2},"children":["Preview"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Preview APIs are available for early integration and may change before they"," ","become stable. Production use should account for shorter migration windows."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"long-term-support","__idx":3},"children":["Long-term support"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["An older stable channel may remain available as an LTS channel while customers"," ","migrate to a newer major version. Ingrid announces its sunset date when the LTS"," ","channel opens."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"product-availability","__idx":4},"children":["Product availability"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The version picker is scoped to the current product area. It lists only the"," ","channels where that product exists. Global references, such as error and country"," ","pages, apply to every channel and therefore do not display a picker."]}]},"headings":[{"value":"API versioning","id":"api-versioning","depth":1},{"value":"Stable","id":"stable","depth":2},{"value":"Preview","id":"preview","depth":2},{"value":"Long-term support","id":"long-term-support","depth":2},{"value":"Product availability","id":"product-availability","depth":2}],"frontmatter":{"title":"API Versioning","description":"How Ingrid API channels evolve","seo":{"title":"API versioning"}},"lastModified":"2026-09-15T13:13:43.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/developer-resources/ingrid-api/versioning","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}