HTTP Versioning
- The current stable version is
v1in the URL path, e.g.https://api.bota.dev/v1/.... - Breaking changes will ship behind a new URL prefix (e.g.,
/v2).
Backwards Compatibility
- Additive changes (new fields/endpoints) will not bump the version.
- Deprecated fields will remain for at least one minor cycle with notice in the changelog.
SDKs
- SDKs follow semantic versioning (semver). Pin a minor version (e.g.,
^1.2.0) and monitor the changelog for breaking updates.