feat(backend): Add enterprise connection resource

[LauraBeatris]

Description

This PR introduces the EnterpriseConnection resource to BAPI, based on https://clerk.com/docs/reference/backend-api/tag/enterprise-connections/post/enterprise_connections

It also deprecates SamlConnection

Checklist

• pnpm test runs as expected.
• pnpm build runs as expected.
• (If applicable) JSDoc comments have been added or updated for any package exports
• (If applicable) Documentation has been updated

Type of change

• 🐛 Bug fix
• 🌟 New feature
• 🔨 Breaking change
• 📖 Refactoring / dependency upgrade / documentation
• other:

Summary by CodeRabbit

• New Features
  • Added EnterpriseConnection resource for creating and managing both OIDC and SAML enterprise connections with unified interface and centralized configuration options.
  • Enables flexible enterprise authentication integration with support for multiple connection types.
  • Deprecated SamlConnection resource; migrate to EnterpriseConnection for improved functionality and better management of enterprise connections.

[vercel]

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

Project	Deployment	Actions	Updated (UTC)
clerk-js-sandbox	Ready	Preview, Comment	Mar 10, 2026 1:24am

[changeset-bot]

🦋 Changeset detected

Latest commit: 1adbf8c

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

This PR includes changesets to release 11 packages

Name	Type
@clerk/backend	Minor
@clerk/agent-toolkit	Patch
@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

[coderabbitai]

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: Repository YAML (base), Organization UI (inherited)

Review profile: CHILL

Plan: Pro

Run ID: af007425-e79b-4c5c-af88-f082025cba85

📥 Commits

Reviewing files that changed from the base of the PR and between e486043 and 1adbf8c.

📒 Files selected for processing (10)

• .changeset/slick-berries-tie.md
• packages/backend/src/api/endpoints/EnterpriseConnectionApi.ts
• packages/backend/src/api/endpoints/index.ts
• packages/backend/src/api/factory.ts
• packages/backend/src/api/resources/Deserializer.ts
• packages/backend/src/api/resources/EnterpriseConnection.ts
• packages/backend/src/api/resources/JSON.ts
• packages/backend/src/api/resources/SamlConnection.ts
• packages/backend/src/api/resources/index.ts
• packages/backend/src/index.ts

---

📝 Walkthrough

Walkthrough

This pull request introduces a new EnterpriseConnection resource to the Clerk backend API package. A new API endpoint class is created with methods for CRUD operations on enterprise connections. The resource includes support for OIDC and SAML connection parameters. A corresponding resource class and JSON interface are added to handle deserialization and type definitions. The factory is updated to expose the new API client, and the existing SamlConnection class is marked as deprecated. The new resource is exported through the package's public API surface.

🚥 Pre-merge checks | ✅ 2 | ❌ 1

❌ Failed checks (1 warning)

Check name	Status	Explanation	Resolution
Docstring Coverage	⚠️ Warning	Docstring coverage is 50.00% which is insufficient. The required threshold is 80.00%.	Write docstrings for the functions missing them to satisfy the coverage threshold.

✅ Passed checks (2 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	The pull request title 'feat(backend): Add enterprise connection resource' accurately describes the main change: introducing a new EnterpriseConnection resource to the backend package with full CRUD operations.

_{✏️ Tip: You can configure your own custom pre-merge checks in the settings.}

---

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

[pkg-pr-new]

Open in StackBlitz

@clerk/agent-toolkit

npm i https://pkg.pr.new/@clerk/agent-toolkit@8017

@clerk/astro

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

@clerk/backend

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

@clerk/chrome-extension

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

@clerk/clerk-js

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

@clerk/dev-cli

npm i https://pkg.pr.new/@clerk/dev-cli@8017

@clerk/expo

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

@clerk/expo-passkeys

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

@clerk/express

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

@clerk/fastify

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

@clerk/hono

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

@clerk/localizations

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

@clerk/nextjs

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

@clerk/nuxt

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

@clerk/react

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

@clerk/react-router

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

@clerk/shared

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

@clerk/tanstack-react-start

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

@clerk/testing

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

@clerk/ui

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

@clerk/upgrade

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

@clerk/vue

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

commit: 1adbf8c