Model versions and maturity

Model versioning

The Timefold Platform can run multiple versions of models. The version of a model is indicated on the Platform Dashboard page, as well as on the Model’s Overview page. The model’s version represents an API contract, meaning that integrations will not break as long as a model’s version stays the same.

Maturity levels

Each version of the model includes the maturity of the model on the Dashboard and Model Information pages. We have defined the following maturity levels:

Example	Example models are usually the first version of a model. The main purpose of these models is to showcase a given use case in action and serve as technology proof-points.
Experimental	Experimental models are models that are actively worked. You can assess the model’s features and quickly access to its capability. Experimental models are likely to change a lot.
Preview	Models that have been mostly developed, but still need to be tested are labeled Preview. They are offered to early adopters to provide feedback as we refine the features. At this stage some backward incompatible changes can still be introduced.
Stable	These models are considered enterprise-ready. They have been developed and released under a given version number. Stability brings guarantees of backward compatibility so you can expect the model to behave consistently with new releases.
Deprecated	Models with this label are no longer supported on the platform, and will soon be removed.

Models will typically start as examples or experimental and become stable over time.