{"componentChunkName":"component---src-templates-simple-markdown-js","path":"/api/getting-started/headers/versioning/","matchPath":"","result":{"data":{"markdownRemark":{"html":"

X-Musement-Version header

\n

By default, accessing the API uses the latest available version. However, this is not necessarily the latest stable version. As we develop a new version, major changes may be introduced which can negatively affect your integration.

\n

To avoid issues related to changes, you can specify the API version using the X-Musement-Version header. When setting up an integration with the Musement API, we strongly suggest using the latest stable version and specifying that version number in every request.

\n

In the example below, we are requesting the current stable version, 3.4.0:

\n
\n
\n
Copy
\n
Copied
\n
\n 
curl -X GET '{baseUrl}/activities/{activityUuid}' \\\n-H 'X-Musement-Application: {applicationValue}' \\\n-H 'X-Musement-Version: 3.4.0' \\\n-H 'Authorization: Bearer {accessToken}'
\n
\n

When a new stable API version is released, the documentation will contain a complete list of changes. Partners can choose to upgrade to the latest version or not by changing the X-Musement-Version header value of their requests.

\n
Version 3.5.0

The documentation now includes details about upcoming version 3.5.0 of the API. Partners are not required to upgrade their integrations at this time, but are encouraged to check out changes from version 3.4.0.

","headings":[{"value":"X-Musement-Version header","depth":1}]},"contentItem":{"data":{"lastModified":"2025-12-18T16:31:42.000Z","enableToc":null,"disableLastModified":null,"tocMaxDepth":null,"requestLogin":false}},"siteConfig":{"enableToc":false,"disableLastModified":false,"tocMaxDepth":4}},"pageContext":{"matchPath":"","id":"1cfe3f0b-3b90-5d06-818a-2ec85cae4c96__redocly content/api/getting-started/headers/versioning/","seo":{"title":"X-Musement-Version header","description":"The Musement API offers different versions with new features and changes.","image":"","keywords":null,"jsonLd":null,"lang":null,"siteUrl":null},"pageId":"api/getting-started/headers/versioning.md","pageBaseUrl":"/api/getting-started/headers/versioning","type":"markdown","toc":{"enable":true,"maxDepth":4,"headings":[{"depth":1,"value":"X-Musement-Version header","id":"x-musement-version-header"}]},"data":{"title":"","redirectFrom":["/guide/overview/versioning/","/api/partner/general-topics/headers/versioning/"],"seo":{"description":"The Musement API offers different versions with new features and changes."}},"catalogInfo":null,"link":"/api/getting-started/headers/versioning/","sidebarName":"__alternative-sidebar__-data-24763-api-sidebars.yaml","isLanding":false,"showPrevButton":null,"showNextButton":null,"apiVersions":null,"apiVersionId":null,"isDefaultApiVersion":null}},"staticQueryHashes":["1123603147","1302185487","1344209882","1398840060","1520077861","1975142765","2667623876","2950305614","3240152602","3743992808","561138138"]}