From 4b729bdf442e7d5ecb924cdd9ad6914208eaeee5 Mon Sep 17 00:00:00 2001 From: Claude Date: Sat, 11 Jul 2026 07:49:58 +0000 Subject: [PATCH] docs(auth): note the none default in the import-users endpoint ref + Console wizard entry The detailed Bulk Import section already documents the none/invite/temporary policies, but the API-reference one-liner still said "invite or temporary" (the pre-#2820 default) and nothing pointed at the Console import wizard shipped in objectui (framework#2782). Adds none as the default to the endpoint reference and a short paragraph on the Users-list Import flow. Co-Authored-By: Claude Fable 5 Claude-Session: https://claude.ai/code/session_016r6eiJzivw1CkwTDSGho1o --- content/docs/permissions/authentication.mdx | 8 +++++++- 1 file changed, 7 insertions(+), 1 deletion(-) diff --git a/content/docs/permissions/authentication.mdx b/content/docs/permissions/authentication.mdx index 597d1b6647..567651b13b 100644 --- a/content/docs/permissions/authentication.mdx +++ b/content/docs/permissions/authentication.mdx @@ -713,6 +713,12 @@ every row through better-auth so the accounts are login-capable: - Synchronous only, at most 500 rows per request (password hashing is CPU-bound); split larger files into batches. Imports are not undoable. +In the Console, platform admins reach this from the **Users list → Import** +toolbar button (shown when the admin plugin is enabled). The import wizard +uploads a CSV/Excel file, maps columns, previews with a dry-run, and — for +the `temporary` policy — reveals the generated passwords once with a +download, splitting files above 500 rows into batches automatically. + --- ## Client Integration @@ -836,7 +842,7 @@ All endpoints are available under `/api/v1/auth/*`: - `POST /api/v1/auth/admin/create-user` - Create a login-capable account (optional one-time temporary password + forced change) - `POST /api/v1/auth/admin/set-user-password` - Set/reset a user's password (also provisions a credential for SSO-onboarded users) -- `POST /api/v1/auth/admin/import-users` - Bulk import users (CSV/JSON/XLSX; invite or temporary password policy; ≤500 rows, dry-run supported) +- `POST /api/v1/auth/admin/import-users` - Bulk import users (CSV/JSON/XLSX; `none` (default) / `invite` / `temporary` password policy; ≤500 rows, dry-run supported) - `POST /api/v1/auth/admin/unlock-user` - Clear a brute-force lockout early For complete API documentation, see the [Better-Auth API Reference](https://www.better-auth.com/docs).