Skip to content

chore(backend): remove retired enhanced email deliverability setting - #9586

Draft
jescalan wants to merge 1 commit into
mainfrom
je/remove-postmark
Draft

jescalan wants to merge 1 commit into
mainfrom
je/remove-postmark

Conversation

@jescalan

@jescalan jescalan commented Aug 26, 2026 •

Copy link
Copy Markdown
Contributor

Summary

Follow-up to the Postmark send-path removal (clerk_go#21398). That PR deleted the behavior; this one deletes the field.

The setting no longer affects anything: routing, unverified-DNS suppression, template forcing, and the magic-link validator were all removed, and every remaining instance was flipped to false in production on 2026-08-26 (20 production + 14 development). What is left is an inert boolean on the API surface, plus dead config.

Rollout ordering

Only one ordering constraint remains:

  1. clerk_go#21398 (behavior removal) — merged and released.
  2. dashboard#10112 before clerk_go#21613. #21613 stops DAPI returning enhanced_email_deliverability, and the dashboard reads it today for the email-logs banner. The failure mode is soft — the value would just read as undefined and the banner would hide — but shipping the consumer first avoids a window where the dashboard reads a field the API no longer returns.
  3. clerk_go#21613.

Everything else is independent and can land in any order: backoffice#724 is type-only with no reader, terraform-app-infra#3193 removes config nothing reads (the cenv constants went out with #21398), clk#49 is documentation, and the SDK PRs land on their owners' release cadence.

No released API contract changes. An earlier revision of clerk_go#21613 removed the field from the base FAPI Client schema — which is inherited by all six API versions, so it would have dropped a required field from five stable versions that clients pin to. FAPI and BAPI now keep serializing it as false instead.

Still outstanding after this

The ENHANCED_DELIVERABILITY_POSTMARK_SERVER_TOKEN secrets remain in four SOPS-encrypted files (production and staging, api_common and pubsubworker). They need someone with sops keys. The Postmark account itself also still needs decommissioning.

Changes in this repo

Removes the retired enhancedEmailDeliverability setting from @clerk/backend: the InstanceApi.updateInstance param, the InstanceSettings resource, and its JSON type. The param has been a server-side no-op since the delivery path was retired, and the Backend API now ignores it entirely.

Breaking change to a public type, so a major changeset is included. Flagged as draft for the SDK owners to slot into their release cadence - no rush, the server tolerates clients that still send the field.

Companion PRs

@vercel

vercel Bot commented Aug 26, 2026 •

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
clerk-js-sandbox Ready Ready Preview Aug 28, 2026 2:55pm
swingset Ready Ready Preview Aug 28, 2026 2:55pm

Request Review

@changeset-bot

changeset-bot Bot commented Aug 26, 2026 •

Copy link
Copy Markdown

🦋 Changeset detected

Latest commit: 3d4c750

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 10 packages
Name Type
@clerk/backend Major
@clerk/astro Patch
@clerk/express Patch
@clerk/fastify Patch
@clerk/hono Patch
@clerk/nextjs Patch
@clerk/nuxt Patch
@clerk/react-router Patch
@clerk/tanstack-react-start Patch
@clerk/testing Patch

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

@pkg-pr-new

pkg-pr-new Bot commented Aug 26, 2026 •

Copy link
Copy Markdown

Open in StackBlitz

@clerk/astro

npm i https://pkg.pr.new/@clerk/astro@9586

@clerk/backend

npm i https://pkg.pr.new/@clerk/backend@9586

@clerk/chrome-extension

npm i https://pkg.pr.new/@clerk/chrome-extension@9586

@clerk/clerk-js

npm i https://pkg.pr.new/@clerk/clerk-js@9586

@clerk/electron

npm i https://pkg.pr.new/@clerk/electron@9586

@clerk/electron-passkeys

npm i https://pkg.pr.new/@clerk/electron-passkeys@9586

@clerk/eslint-plugin

npm i https://pkg.pr.new/@clerk/eslint-plugin@9586

@clerk/expo

npm i https://pkg.pr.new/@clerk/expo@9586

@clerk/expo-google-signin

npm i https://pkg.pr.new/@clerk/expo-google-signin@9586

@clerk/expo-passkeys

npm i https://pkg.pr.new/@clerk/expo-passkeys@9586

@clerk/express

npm i https://pkg.pr.new/@clerk/express@9586

@clerk/fastify

npm i https://pkg.pr.new/@clerk/fastify@9586

@clerk/hono

npm i https://pkg.pr.new/@clerk/hono@9586

@clerk/localizations

npm i https://pkg.pr.new/@clerk/localizations@9586

@clerk/nextjs

npm i https://pkg.pr.new/@clerk/nextjs@9586

@clerk/nuxt

npm i https://pkg.pr.new/@clerk/nuxt@9586

@clerk/react

npm i https://pkg.pr.new/@clerk/react@9586

@clerk/react-router

npm i https://pkg.pr.new/@clerk/react-router@9586

@clerk/shared

npm i https://pkg.pr.new/@clerk/shared@9586

@clerk/tanstack-react-start

npm i https://pkg.pr.new/@clerk/tanstack-react-start@9586

@clerk/testing

npm i https://pkg.pr.new/@clerk/testing@9586

@clerk/ui

npm i https://pkg.pr.new/@clerk/ui@9586

@clerk/upgrade

npm i https://pkg.pr.new/@clerk/upgrade@9586

@clerk/vue

npm i https://pkg.pr.new/@clerk/vue@9586

commit: 3d4c750

@jescalan jescalan changed the title Remove the enhanced_email_deliverability API surface chore(backend): remove retired enhanced email deliverability setting Aug 28, 2026

This branch was successfully deployed

2 active deployments
Preview – swingset — 3d4c7507 Deployed Aug 28, 2026 by vercel[bot]
Preview – clerk-js-sandbox — 3d4c7507 Deployed Aug 28, 2026 by vercel[bot]
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant