Add SDK-specificity to Authentication flows, User management, and Session management sections #2595

alexisintech · 2025-09-12T17:17:35Z

🔎 Previews:

https://clerk.com/docs/pr/aa-sdk-specificity-project

⚠️ when #2730 is merged, update session tasks guide

Tip

Just to note that the most used SDKs in order: nextjs, react, express, expo, javascript, js backend

What changed?

Adds examples to support most SDKs. Remix is no longer supported so removes those examples. Go and Ruby have small userbases, so skips adding those.
Ensures links to /backend-api have {{ target: '_blank' }} following them

FIXES DOCS-11112

Checklist

I have clicked on "Files changed" and performed a thorough self-review
All existing checks pass

…in permissions Co-authored-by: Copilot Autofix powered by AI <62310815+github-advanced-security[bot]@users.noreply.github.com>

manovotny · 2025-10-28T22:25:29Z

docs/guides/configure/auth-strategies/social-connections/overview.mdx

+    app.get('/user', async (req, res) => {
+      // The `Auth` object gives you access to properties like `isAuthenticated` and `userId`
+      // Accessing the `Auth` object differs depending on the SDK you're using
+      // https://clerk.com/docs/reference/backend/types/auth-object#how-to-access-the-auth-object


Same "link as comment" note as above.

manovotny · 2025-10-28T22:25:39Z

docs/guides/configure/auth-strategies/social-connections/overview.mdx

+
+      // Initialize the JS Backend SDK
+      // This varies depending on the SDK you're using
+      // https://clerk.com/docs/js-backend/getting-started/quickstart


Same "link as comment" note as above.

manovotny · 2025-10-28T22:25:48Z

docs/guides/configure/auth-strategies/social-connections/overview.mdx

+      const notionResponse = await fetch(notionUrl, {
+        headers: {
+          Authorization: `Bearer ${accessToken}`,
+          'Notion-Version': '2022-06-28',


Same old Notion version comment as above.

manovotny · 2025-10-28T22:26:07Z

docs/guides/configure/auth-strategies/social-connections/overview.mdx

+
+    // Initialize the JS Backend SDK
+    // This varies depending on the SDK you're using
+    // https://clerk.com/docs/js-backend/getting-started/quickstart


Same "link as comment" note as above.

manovotny · 2025-10-28T22:26:14Z

docs/guides/configure/auth-strategies/social-connections/overview.mdx

+    async function getNotionData(request) {
+      // The `Auth` object gives you access to properties like `isAuthenticated` and `userId`
+      // Accessing the `Auth` object differs depending on the SDK you're using
+      // https://clerk.com/docs/reference/backend/types/auth-object#how-to-access-the-auth-object


Same "link as comment" note as above.

manovotny · 2025-10-28T22:26:24Z

docs/guides/configure/auth-strategies/social-connections/overview.mdx

+      const notionResponse = await fetch(notionUrl, {
+        headers: {
+          Authorization: `Bearer ${accessToken}`,
+          'Notion-Version': '2022-06-28',


Same old Notion version comment as above.

manovotny · 2025-10-28T22:26:44Z

docs/guides/configure/auth-strategies/social-connections/overview.mdx

+    export async function loader(args: Route.LoaderArgs) {
+      // The `Auth` object gives you access to properties like `isAuthenticated` and `userId`
+      // Accessing the `Auth` object differs depending on the SDK you're using
+      // https://clerk.com/docs/reference/backend/types/auth-object#how-to-access-the-auth-object


Same "link as comment" note as above.

manovotny · 2025-10-28T22:26:53Z

docs/guides/configure/auth-strategies/social-connections/overview.mdx

+
+      // Initialize the JS Backend SDK
+      // This varies depending on the SDK you're using
+      // https://clerk.com/docs/js-backend/getting-started/quickstart


Same "link as comment" note as above.

manovotny · 2025-10-28T22:27:46Z

docs/guides/configure/auth-strategies/social-connections/overview.mdx

+      const notionResponse = await fetch(notionUrl, {
+        headers: {
+          Authorization: `Bearer ${accessToken}`,
+          'Notion-Version': '2022-06-28',


Same old Notion version comment as above.

manovotny · 2025-10-28T22:28:04Z

docs/guides/configure/auth-strategies/social-connections/overview.mdx

+          GET: async () => {
+            // The `Auth` object gives you access to properties like `isAuthenticated` and `userId`
+            // Accessing the `Auth` object differs depending on the SDK you're using
+            // https://clerk.com/docs/reference/backend/types/auth-object#how-to-access-the-auth-object


Same "link as comment" note as above.

manovotny · 2025-10-28T22:28:10Z

docs/guides/configure/auth-strategies/social-connections/overview.mdx

+
+            // Initialize the JS Backend SDK
+            // This varies depending on the SDK you're using
+            // https://clerk.com/docs/js-backend/getting-started/quickstart


Same "link as comment" note as above.

manovotny · 2025-10-28T22:28:20Z

docs/guides/configure/auth-strategies/social-connections/overview.mdx

+            const notionResponse = await fetch(notionUrl, {
+              headers: {
+                Authorization: `Bearer ${accessToken}`,
+                'Notion-Version': '2022-06-28',


Same old Notion version comment as above.

manovotny · 2025-10-28T22:29:53Z

docs/guides/configure/auth-strategies/social-connections/overview.mdx

+
+      // Use the JS Backend SDK to get the user's OAuth access token
+      const clerkResponse = await client.users.getUserOauthAccessToken(userId, provider)
+      const accessToken = clerkResponse.data[0].token || ''


The previous example was doing the same thing, but do we need to guard against data[0] here (and in all the examples below)? Will it ever not be an array? What if the userId is not found?

manovotny · 2025-10-28T22:32:30Z

docs/guides/configure/session-tasks.mdx

+<If sdk="nextjs">
+  For `auth.protect()`, signed-out users will be redirected to the sign-in page. In the following example, `pending` users will be redirected to the sign-in page, where the `<SignIn />` component will prompt them to fulfill the session tasks. Once finished, their session will move from `pending` to an `active` (signed-in) state.
+
+  ```tsx {{ filename: 'middleware.ts', mark: [[6, 8]] }}


Does this need to be proxy.ts now? If true, do we need to update Middleware references to Proxy in this file too?

manovotny · 2025-10-28T22:33:02Z

docs/guides/configure/session-tasks.mdx

+export default async function Page() {
+  // The `Auth` object gives you access to properties like `isAuthenticated` and `userId`
+  // Accessing the `Auth` object differs depending on the SDK you're using
+  // https://clerk.com/docs/reference/backend/types/auth-object#how-to-access-the-auth-object


Same "link as comment" note as above.

manovotny · 2025-10-28T22:33:41Z

docs/guides/configure/session-tasks.mdx

+export const POST = async () => {
+  // `treatPendingAsSignedOut` is set to `false` to allow access to the `userId` for pending sessions
+  // Accessing the `Auth` object differs depending on the SDK you're using
+  // https://clerk.com/docs/reference/backend/types/auth-object#how-to-access-the-auth-object


Same "link as comment" note as above.

manovotny · 2025-10-28T22:35:24Z

docs/_partials/authenticate-req.mdx

 export async function GET(req: Request) {
+  // Initialize the JS Backend SDK
+  // This varies depending on the SDK you're using
+  // https://clerk.com/docs/js-backend/getting-started/quickstart


Same "link as comment" note as above.

manovotny · 2025-10-28T22:35:36Z

docs/guides/sessions/manual-jwt-verification.mdx

+
+    // Initialize the JS Backend SDK
+    // This varies depending on the SDK you're using
+    // https://clerk.com/docs/js-backend/getting-started/quickstart


Same "link as comment" note as above.

manovotny · 2025-10-28T22:36:39Z

docs/guides/sessions/manual-jwt-verification.mdx

+  <Tab>
+    If you are using the [JS Backend SDK](/docs/js-backend/getting-started/quickstart) on its own, you need to provide the `secretKey` and `publishableKey` to `createClerkClient()` so that it is passed to `authenticateRequest()`. You can set these values as [environment variables](/docs/guides/development/clerk-environment-variables#clerk-publishable-and-secret-keys) and then pass them to the function.
+
+    <Include src="_partials/authenticate-req" />


Why is just this one in a partial and not the rest?

manovotny · 2025-10-28T23:30:45Z

docs/guides/sessions/session-tokens.mdx

-        // Use `auth()` to access `isAuthenticated` and the user's ID
+        // The `Auth` object gives you access to properties like `isAuthenticated` and `userId`
+        // Accessing the `Auth` object differs depending on the SDK you're using
+        // https://clerk.com/docs/reference/backend/types/auth-object#how-to-access-the-auth-object


Same "link as comment" note as above.

manovotny · 2025-10-28T23:30:51Z

docs/guides/sessions/session-tokens.mdx


+        // Initialize the JS Backend SDK
+        // This varies depending on the SDK you're using
+        // https://clerk.com/docs/js-backend/getting-started/quickstart


Same "link as comment" note as above.

manovotny · 2025-10-28T23:30:59Z

docs/guides/sessions/session-tokens.mdx

-      // Use `locals.auth()` to access `isAuthenticated` and the user's ID
+      // The `Auth` object gives you access to properties like `isAuthenticated` and `userId`
+      // Accessing the `Auth` object differs depending on the SDK you're using
+      // https://clerk.com/docs/reference/backend/types/auth-object#how-to-access-the-auth-object


Same "link as comment" note as above.

manovotny · 2025-10-28T23:31:12Z

docs/guides/sessions/session-tokens.mdx

-      // Use the JS Backend SDK's `getUser()` method to get the Backend User object
+      // Initialize the JS Backend SDK
+      // This varies depending on the SDK you're using
+      // https://clerk.com/docs/js-backend/getting-started/quickstart


Same "link as comment" note as above.

manovotny · 2025-10-28T23:31:20Z

docs/guides/sessions/session-tokens.mdx

-      // Use `getAuth()` to access `isAuthenticated` and the user's ID
+      // The `Auth` object gives you access to properties like `isAuthenticated` and `userId`
+      // Accessing the `Auth` object differs depending on the SDK you're using
+      // https://clerk.com/docs/reference/backend/types/auth-object#how-to-access-the-auth-object


Same "link as comment" note as above.

manovotny · 2025-10-28T23:31:27Z

docs/guides/sessions/session-tokens.mdx

-      // Use the JS Backend SDK's `getUser()` method to get the Backend User object
+      // Initialize the JS Backend SDK
+      // This varies depending on the SDK you're using
+      // https://clerk.com/docs/js-backend/getting-started/quickstart


Same "link as comment" note as above.

manovotny · 2025-10-28T23:31:32Z

docs/guides/sessions/session-tokens.mdx

-      // Use `getAuth()` to access `isAuthenticated` and the user's ID
+      // The `Auth` object gives you access to properties like `isAuthenticated` and `userId`
+      // Accessing the `Auth` object differs depending on the SDK you're using
+      // https://clerk.com/docs/reference/backend/types/auth-object#how-to-access-the-auth-object


Same "link as comment" note as above.

manovotny · 2025-10-28T23:31:39Z

docs/guides/sessions/session-tokens.mdx

-      // Get the Backend User object
+      // Initialize the JS Backend SDK
+      // This varies depending on the SDK you're using
+      // https://clerk.com/docs/js-backend/getting-started/quickstart


Same "link as comment" note as above.

manovotny · 2025-10-28T23:31:51Z

docs/guides/sessions/session-tokens.mdx

+          GET: async () => {
+            // The `Auth` object gives you access to properties like `isAuthenticated` and `userId`
+            // Accessing the `Auth` object differs depending on the SDK you're using
+            // https://clerk.com/docs/reference/backend/types/auth-object#how-to-access-the-auth-object


Same "link as comment" note as above.

manovotny · 2025-10-28T23:31:57Z

docs/guides/sessions/session-tokens.mdx

+
+            // Initialize the JS Backend SDK
+            // This varies depending on the SDK you're using
+            // https://clerk.com/docs/js-backend/getting-started/quickstart


Same "link as comment" note as above.

manovotny · 2025-10-28T23:38:23Z

docs/guides/users/inviting.mdx

 ## Create an invitation

-You can create an invitation in the [Clerk Dashboard](#using-clerk-dashboard) or [using the Backend API](#using-backend-api).
+You can create an invitation either in the [Clerk Dashboard](#in-the-clerk-dashboard) or [programmatically](#programmatically). When making this decision, keep in mind that if you create an invitation through the Clerk Dashboard, you can only set an invitation expiration date. If you create an invitation programatically, you are able to set more options, such as the URL you want the user to be redirected to after they accept the invitation, metadata to add to the invitation, or whether an invitation should be created if there is already an existing invitation for the given email address.


I understand that we're documenting how it currently works, but this feels like we should push to have these capabilities available via the dashboard too.

NWylynko and others added 30 commits July 17, 2025 14:12

bring in kyles scripts

4fd7d1b

support top level and nested items

28f40e2

add watch script

b62ccef

Add mapping generation to build ci

edeef17

run migration map checker in gh action

f288985

flip order

4349075

run on push to test ci

c3d5cc2

generate the manifest first

7da6b58

remove watch from tsx cli

d41ab9f

define flags in this repo instead of clerk/clerk

be7e558

Only enable ci on certain file changes

e8fb05c

disable feature flags

b22f559

fix up tests

c32a424

Potential fix for code scanning alert no. 10: Workflow does not conta…

7c8f48b

…in permissions Co-authored-by: Copilot Autofix powered by AI <62310815+github-advanced-security[bot]@users.noreply.github.com>

add support for 3rd level dropdown

b919b0f

Add a readme for new scripts

794d218

Add dotenv

8797e04

activate top-level manifest splitting and proposal generation

6d75db8

add support for icons in proposal.md. add more to proposal

2db149f

revise proposal

15b54b6

proposal checkpoint

e832559

proposal checkpoint

580f0d0

add sub top-level categories under reference

d1c0c09

update proposal from content tuple

5e5ef6e

progress checkin: mostly mappings

a33d50d

triage webhooks section

fe30e22

update

7d67070

work on the mapping script

cc98875

Add --fix arg

7a87a82

Add script for much better doc deletion

541bf8a

manovotny reviewed Oct 28, 2025

View reviewed changes

Uh oh!

Add SDK-specificity to Authentication flows, User management, and Session management sections #2595

Are you sure you want to change the base?

Add SDK-specificity to Authentication flows, User management, and Session management sections #2595

Uh oh!

Conversation

alexisintech commented Sep 12, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

🔎 Previews:

What changed?

Checklist

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

6 participants

alexisintech commented Sep 12, 2025 •

edited

Loading