From d09821f6b0b70105fcd382c797fec7dcd5699816 Mon Sep 17 00:00:00 2001
From: Kyle Gonzalez <kyle.gonzalez@authlete.com>
Date: Wed, 3 Jun 2026 16:18:23 +0900
Subject: [PATCH 1/3] feat: Add INVALID_SCOPE auth failure reason

---
 .../authlete/common/dto/AuthorizationFailRequest.java | 11 +++++++++++
 1 file changed, 11 insertions(+)

diff --git a/src/main/java/com/authlete/common/dto/AuthorizationFailRequest.java b/src/main/java/com/authlete/common/dto/AuthorizationFailRequest.java
index 4a690ba4a0..9083dc1212 100644
--- a/src/main/java/com/authlete/common/dto/AuthorizationFailRequest.java
+++ b/src/main/java/com/authlete/common/dto/AuthorizationFailRequest.java
@@ -261,6 +261,17 @@ public enum Reason
          * @since 2.62
          */
         INVALID_TARGET,
+
+        /**
+         * The requested scope is invalid.
+         *
+         * <p>
+         * Using this reason will result in {@code error=invalid_scope}.
+         * </p>
+         *
+         * @since 3.0.33
+         */
+        INVALID_SCOPE,
     }
 
 

From 7051fa9dde08b25884b25d028f2642b6668c7244 Mon Sep 17 00:00:00 2001
From: Kyle Gonzalez <kyle.gonzalez@authlete.com>
Date: Fri, 5 Jun 2026 13:26:12 +0900
Subject: [PATCH 2/3] feat: Add UNAUTHORIZED_CLIENT and TEMPORARILY_UNAVAILABLE
 auth failure reasons.

---
 .../common/dto/AuthorizationFailRequest.java  | 21 +++++++++++++++++++
 1 file changed, 21 insertions(+)

diff --git a/src/main/java/com/authlete/common/dto/AuthorizationFailRequest.java b/src/main/java/com/authlete/common/dto/AuthorizationFailRequest.java
index 9083dc1212..1645428cbf 100644
--- a/src/main/java/com/authlete/common/dto/AuthorizationFailRequest.java
+++ b/src/main/java/com/authlete/common/dto/AuthorizationFailRequest.java
@@ -272,6 +272,27 @@ public enum Reason
          * @since 3.0.33
          */
         INVALID_SCOPE,
+
+        /**
+         * The client is not authorized to perform the requested operation.
+         *
+         * <p>
+         *  Using this reason will result in {@code error=unauthorized_client}.
+         * </p>
+         * @since 3.0.33
+         */
+        UNAUTHORIZED_CLIENT,
+
+        /**
+         * The requested operation is temporarily unavailable and cannot be performed at this time.
+         *
+         * <p>
+         *  Using this reason will result in {@code error=temporarily_unavailable}.
+         * </p>
+         *
+         * @since 3.0.33
+         */
+        TEMPORARILY_UNAVAILABLE,
     }
 
 

From 3b5c1a46909a34f9328154a4a6aea45f5499a426 Mon Sep 17 00:00:00 2001
From: Kyle Gonzalez <kyle.gonzalez@authlete.com>
Date: Fri, 5 Jun 2026 13:30:12 +0900
Subject: [PATCH 3/3] chore: Update CHANGES.md

---
 CHANGES.ja.md | 9 +++++++++
 CHANGES.md    | 9 +++++++++
 2 files changed, 18 insertions(+)

diff --git a/CHANGES.ja.md b/CHANGES.ja.md
index eafa5c4288..fc1c127d7f 100644
--- a/CHANGES.ja.md
+++ b/CHANGES.ja.md
@@ -1,6 +1,15 @@
 変更点
 ======
 
+4.46 ()
+--------------------------
+
+- `AuthorizationFailRequest.Reason` 列挙型
+  * `INVALID_SCOPE` を追加。
+  * `UNAUTHORIZED_CLIENT` を追加。
+  * `TEMPORARILY_UNAVAILABLE` を追加。
+
+
 4.45 (2026 年 05 月 18 日)
 --------------------------
 
diff --git a/CHANGES.md b/CHANGES.md
index f083fa0940..6b984af655 100644
--- a/CHANGES.md
+++ b/CHANGES.md
@@ -1,6 +1,15 @@
 CHANGES
 =======
 
+4.46 ()
+-----------------
+
+- `AuthorizationFailRequest.Reason` enum
+  * Added `INVALID_SCOPE`
+  * Added `UNAUTHORIZED_CLIENT`
+  * Added `TEMPORARILY_UNAVAILABLE`
+
+
 4.45 (2026-05-18)
 -----------------