Available versions
Below is a list of all the available API versions with their respective breaking changes. For information on how to apply the appropriate version, see Versioning overview.
2025-04-10
Adds support for version 2 of Clerk session tokens. The following SDKs are compatible with this version:
SDK | Version |
---|---|
Clerk.js | @clerk/clerk-js v5.61.0 or higher |
Next.js | @clerk/nextjs v6.15.0 or higher |
Astro | @clerk/astro v2.6.4 or higher |
Expo | @clerk/expo v2.9.12 or higher |
Express | @clerk/express v1.4.5 or higher |
Fastify | @clerk/fastify v2.2.5 or higher |
Go | clerk-sdk-go v2.3.1 or higher |
JavaScript Backend | @clerk/backend v1.28.0 or higher |
Nuxt.js | @clerk/nuxt v1.5.5 or higher |
React Router | @clerk/react-router v1.2.5 or higher |
Remix | @clerk/remix v4.5.17 or higher |
Ruby | clerk-sdk-ruby v4.1.0 or higher |
TanStack React Start | @clerk/tanstack-react-start v0.13.5 or higher |
2024-10-01
- Notification for new sign-ins to users' accounts feature becomes available.
- The response for sign-ins with an email address that matches a SAML connection is updated:
- Instead of responding with a status of
needs_identifier
, the API now returns a status ofneeds_first_factor
. - The email address that matched will be returned in the identifier field.
- The only strategy that will be included in supported first factors is
enterprise_sso
.
- Instead of responding with a status of
2021-02-05
The initial API version was released on 2021-02-05 as part of the first Clerk release. It predates the versioning system. All changes made to it since then are backwards compatible.
Feedback
Last updated on