From 3d4c750757f22e8152e37d7edbc4996367251768 Mon Sep 17 00:00:00 2001
From: Jeff Escalante <jescalan@users.noreply.github.com>
Date: Wed, 26 Aug 2026 17:41:50 -0400
Subject: [PATCH] Remove the retired enhancedEmailDeliverability instance
 setting from @clerk/backend

---
 .changeset/tidy-pandas-retire-eed.md                   | 9 +++++++++
 packages/backend/src/api/endpoints/InstanceApi.ts      | 2 --
 packages/backend/src/api/resources/InstanceSettings.ts | 2 --
 packages/backend/src/api/resources/JSON.ts             | 1 -
 4 files changed, 9 insertions(+), 5 deletions(-)
 create mode 100644 .changeset/tidy-pandas-retire-eed.md

diff --git a/.changeset/tidy-pandas-retire-eed.md b/.changeset/tidy-pandas-retire-eed.md
new file mode 100644
index 00000000000..12e020aa342
--- /dev/null
+++ b/.changeset/tidy-pandas-retire-eed.md
@@ -0,0 +1,9 @@
+---
+'@clerk/backend': major
+---
+
+Remove the retired `enhancedEmailDeliverability` instance setting. The
+underlying delivery path (Clerk's legacy shared-domain sending) has been
+retired server-side, and the field is ignored by the Backend API, so it is
+removed from `InstanceApi.updateInstance` params, the `InstanceSettings`
+resource, and its JSON type.
diff --git a/packages/backend/src/api/endpoints/InstanceApi.ts b/packages/backend/src/api/endpoints/InstanceApi.ts
index 884dbd84528..653b227cdf0 100644
--- a/packages/backend/src/api/endpoints/InstanceApi.ts
+++ b/packages/backend/src/api/endpoints/InstanceApi.ts
@@ -12,8 +12,6 @@ export type UpdateParams = {
   testMode?: boolean | null | undefined;
   /** Whether the instance should be using the Have I Been Pwned (HIBP) service to check passwords for breaches. */
   hibp?: boolean | null | undefined;
-  /** Whether the instance should send emails from "verifications@clerk.dev" instead of your domain. This can be helpful if you do not have a high domain reputation. */
-  enhancedEmailDeliverability?: boolean | null | undefined;
   /** The support email for the instance. */
   supportEmail?: string | null | undefined;
   /** The npm version for `@clerk/clerk-js`. */
diff --git a/packages/backend/src/api/resources/InstanceSettings.ts b/packages/backend/src/api/resources/InstanceSettings.ts
index 47cc03eecad..9e14b6e8d9a 100644
--- a/packages/backend/src/api/resources/InstanceSettings.ts
+++ b/packages/backend/src/api/resources/InstanceSettings.ts
@@ -6,7 +6,6 @@ export class InstanceSettings {
     readonly restrictedToAllowlist?: boolean | undefined,
     readonly fromEmailAddress?: string | undefined,
     readonly progressiveSignUp?: boolean | undefined,
-    readonly enhancedEmailDeliverability?: boolean | undefined,
   ) {}
 
   static fromJSON(data: InstanceSettingsJSON): InstanceSettings {
@@ -15,7 +14,6 @@ export class InstanceSettings {
       data.restricted_to_allowlist,
       data.from_email_address,
       data.progressive_sign_up,
-      data.enhanced_email_deliverability,
     );
   }
 }
diff --git a/packages/backend/src/api/resources/JSON.ts b/packages/backend/src/api/resources/JSON.ts
index e1ff98e2ee1..e0bb95e0fdf 100644
--- a/packages/backend/src/api/resources/JSON.ts
+++ b/packages/backend/src/api/resources/JSON.ts
@@ -323,7 +323,6 @@ export interface InstanceSettingsJSON extends ClerkResourceJSON {
   restricted_to_allowlist: boolean;
   from_email_address: string;
   progressive_sign_up: boolean;
-  enhanced_email_deliverability: boolean;
 }
 
 export interface InvitationJSON extends ClerkResourceJSON {