║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║

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 | | Java | com.clerk:backend-api v3.0.0 or higher | | Nuxt.js | @clerk/nuxt v1.5.5 or higher | | PHP | clerkinc/backend-php v0.1.6 or higher | | Python | clerk_backend_api v2.2.0 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 | | C# | Clerk.BackendAPI v0.2.1 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 of needs_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.

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.

║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║