Add changes for api version 2024-10-01 (#1717)

Co-authored-by: victoria <[email protected]> Co-authored-by: Alexis Aguilar <[email protected]>
clerk · Nov 28, 2024 · 07885ed · 07885ed
1 parent 9d14007
commit 07885ed
Showing 1 changed file with 8 additions and 0 deletions.
diff --git a/docs/backend-requests/versioning/available-versions.mdx b/docs/backend-requests/versioning/available-versions.mdx
@@ -5,6 +5,14 @@ description: A list of the available API versions and their breaking changes.
 
 Below is a list of all the available API versions with their respective breaking changes.
 
+### 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.