It's very important to always use the X-Musement-Version header.

When you start a new project that uses Musement API, set the X-Musement-Version header to the latest version available. This assures that the model in the response will be stable with time.



You can use Musement API without specifing the specific version you want.
You will be served the latest available version.
If you follow this road you're subject to breaking changes that may be introduced in future releases. So your application will probably break.

When a new version is released, you can check the documentation and choose to upgrade your header or remain with your version. You can also specify different versions for different calls, but we discourage this practice.

Calling an endpoint setting X-Musement-Version to 3.4.0

curl -X GET \
  -H 'X-Musement-Version: 3.4.0'