Skip to main content

​
Overview

Hanko 3.0.0 removes previously deprecated API endpoints. This guide outlines the breaking changes and migration path for upgrading from version 2.x.x to 3.0.0.
Hanko 3.0.0 is scheduled for release on Hanko Cloud on May 20, 2026. Please plan your migration accordingly.

​
Breaking Changes

​
Deprecated API Endpoints

The following Public API endpoints have been deprecated and will be removed in version 3.0.0: Authentication Endpoints: WebAuthn Endpoints: Configuration & Authentication: User Management: Email Management: SAML:

​
Migration Path

Exception: If your integration only uses, hanko-elements version 1.0.0 or later, and not using the Hanko API directly, no migration changes are required.
All deprecated endpoints have been replaced with the new Flow API, which provides a unified and streamlined authentication interface. Check out the Understanding the Flow API guide and Build a custom login flow guide for more information about building your own custom UI.

​
Action Required

To ensure a smooth transition:
  1. Review your current implementation and identify usage of deprecated endpoints
  2. Migrate to the Flow API before the May 20, 2026 release date
  3. Test your integration thoroughly in a development environment
  4. Refer to the Flow API documentation for implementation details
Need assistance with your migration? Contact our support team or visit our community forum for help.