From c783ff45af8f7442fbc18a3e527f88de656eedc7 Mon Sep 17 00:00:00 2001
From: Maxwell <145994855+ping-maxwell@users.noreply.github.com>
Date: Wed, 24 Sep 2025 05:29:14 +1000
Subject: [PATCH] docs(admin): added missing `updateUser` api (#4846)

---
 docs/content/docs/plugins/admin.mdx           | 23 +++++++++++++++++++
 .../better-auth/src/plugins/admin/admin.ts    | 15 ++++++++++++
 2 files changed, 38 insertions(+)

diff --git a/docs/content/docs/plugins/admin.mdx b/docs/content/docs/plugins/admin.mdx
index 331c3bc65a..6c367d5ee1 100644
--- a/docs/content/docs/plugins/admin.mdx
+++ b/docs/content/docs/plugins/admin.mdx
@@ -259,6 +259,29 @@ type setUserPassword = {
 ```
 </APIMethod>
 
+### Update user
+
+Update a user's details.
+
+<APIMethod
+  path="/admin/update-user"
+  method="POST"
+  requireSession
+>
+```ts
+type adminUpdateUser = {
+    /**
+     * The user id which you want to update.
+     */
+    userId: string = "user-id"
+    /**
+     * The data to update.
+     */
+    data: Record<string, any> = { name: "John Doe" }
+}
+```
+</APIMethod>
+
 ### Ban User
 
 Bans a user, preventing them from signing in and revokes all of their existing sessions.
diff --git a/packages/better-auth/src/plugins/admin/admin.ts b/packages/better-auth/src/plugins/admin/admin.ts
index e04930f75d..f315ff84bf 100644
--- a/packages/better-auth/src/plugins/admin/admin.ts
+++ b/packages/better-auth/src/plugins/admin/admin.ts
@@ -492,6 +492,21 @@ export const admin = <O extends AdminOptions>(options?: O) => {
 					});
 				},
 			),
+			/**
+			 * ### Endpoint
+			 *
+			 * POST `/admin/update-user`
+			 *
+			 * ### API Methods
+			 *
+			 * **server:**
+			 * `auth.api.adminUpdateUser`
+			 *
+			 * **client:**
+			 * `authClient.admin.updateUser`
+			 *
+			 * @see [Read our docs to learn more.](https://better-auth.com/docs/plugins/admin#api-method-admin-update-user)
+			 */
 			adminUpdateUser: createAuthEndpoint(
 				"/admin/update-user",
 				{