From 2ced69d4aec8c9c96f08b2530f67a6e164977f07 Mon Sep 17 00:00:00 2001
From: Alexis Pesicka <14352901+pesickaa@users.noreply.github.com>
Date: Mon, 8 Jun 2026 12:23:39 +0100
Subject: [PATCH 1/2] feat: add new error code description and troubleshooting
 for 4321

---
 .../docs/get-started/guides/error-codes.mdx        | 14 ++++++++++++++
 1 file changed, 14 insertions(+)

diff --git a/src/content/docs/get-started/guides/error-codes.mdx b/src/content/docs/get-started/guides/error-codes.mdx
index 8a3724473..8380c6f18 100644
--- a/src/content/docs/get-started/guides/error-codes.mdx
+++ b/src/content/docs/get-started/guides/error-codes.mdx
@@ -190,6 +190,20 @@ Description
 Troubleshooting
 - Check the secret being used with your social provider and ensure that it hasn't expired
 
+## Error code 4321
+
+Description
+- This error typically occurs when a user attempts to access a login flow from a mid-step URL instead of starting from the beginning.
+- Reasons this error may occur: 
+  - A bookmarked or previously used URL is reused
+  - A step-specific URL is shared directly
+  - The user navigates back or forward in the browser and skips required steps in the flow
+
+Troubleshooting
+- Ask the user to restart the login flow from the main entry point, such as your app’s login page
+- Clear browser cookies and cache before retrying
+- Avoid using any bookmarked or shared login URLs
+
 ## Error code 4617
 
 Description

From 7ece11f41a5e73fb6dc8115ef4c63a547e00c6a2 Mon Sep 17 00:00:00 2001
From: Alexis Pesicka <14352901+pesickaa@users.noreply.github.com>
Date: Tue, 9 Jun 2026 09:29:21 +0100
Subject: [PATCH 2/2] chore: CRAI nitpick about using authentication flow over
 login flow

---
 src/content/docs/get-started/guides/error-codes.mdx | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/src/content/docs/get-started/guides/error-codes.mdx b/src/content/docs/get-started/guides/error-codes.mdx
index 8380c6f18..41f0b5db7 100644
--- a/src/content/docs/get-started/guides/error-codes.mdx
+++ b/src/content/docs/get-started/guides/error-codes.mdx
@@ -193,8 +193,8 @@ Troubleshooting
 ## Error code 4321
 
 Description
-- This error typically occurs when a user attempts to access a login flow from a mid-step URL instead of starting from the beginning.
-- Reasons this error may occur: 
+- This error typically occurs when a user attempts to access an authentication flow from a mid-step URL instead of starting from the beginning.
+- Reasons this error may occur:
   - A bookmarked or previously used URL is reused
   - A step-specific URL is shared directly
   - The user navigates back or forward in the browser and skips required steps in the flow