Versioning
When updates are made to our API that are not compatible with the previous version, a new version is released.
The most recent version is v2.0.0 and it is the default version to use when starting a new integration.
When navigating the API Reference documentation, you can access the older version by scrolling to the footer and clicking OnceHub v1 (Deprecated) under the "Docs" section.
Version History
v2.0.0 is the current and recommended version for all new integrations. This version includes the latest features and improvements.
Backward Compatibility
When breaking changes are necessary, we release a new API version to ensure existing integrations continue to work without interruption. Previous versions remain supported to give you time to migrate at your own pace.
When planning to migrate to a newer API version, we recommend:
- Review the changelog for breaking changes
- Test your integration thoroughly in a development environment
- Update your API calls gradually
- Monitor your integration after migration