HTTP API stability
Ditto uses schema-versioning at the HTTP API level in order to being able to evolve breaking APIs.
HTTP API version 2 is the currently only supported API version.
Java API stability
The Java APIs will for the 2.x release will be kept backwards compatible to 2.x, so only non-breaking additions to the APIs will be done. This is enforced by a Maven tooling.