Skip to content

Commit 4b729bd

Browse files
committed
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 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_016r6eiJzivw1CkwTDSGho1o
1 parent a348394 commit 4b729bd

1 file changed

Lines changed: 7 additions & 1 deletion

File tree

content/docs/permissions/authentication.mdx

Lines changed: 7 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -713,6 +713,12 @@ every row through better-auth so the accounts are login-capable:
713713
- Synchronous only, at most 500 rows per request (password hashing is
714714
CPU-bound); split larger files into batches. Imports are not undoable.
715715

716+
In the Console, platform admins reach this from the **Users list → Import**
717+
toolbar button (shown when the admin plugin is enabled). The import wizard
718+
uploads a CSV/Excel file, maps columns, previews with a dry-run, and — for
719+
the `temporary` policy — reveals the generated passwords once with a
720+
download, splitting files above 500 rows into batches automatically.
721+
716722
---
717723

718724
## Client Integration
@@ -836,7 +842,7 @@ All endpoints are available under `/api/v1/auth/*`:
836842

837843
- `POST /api/v1/auth/admin/create-user` - Create a login-capable account (optional one-time temporary password + forced change)
838844
- `POST /api/v1/auth/admin/set-user-password` - Set/reset a user's password (also provisions a credential for SSO-onboarded users)
839-
- `POST /api/v1/auth/admin/import-users` - Bulk import users (CSV/JSON/XLSX; invite or temporary password policy; ≤500 rows, dry-run supported)
845+
- `POST /api/v1/auth/admin/import-users` - Bulk import users (CSV/JSON/XLSX; `none` (default) / `invite` / `temporary` password policy; ≤500 rows, dry-run supported)
840846
- `POST /api/v1/auth/admin/unlock-user` - Clear a brute-force lockout early
841847

842848
For complete API documentation, see the [Better-Auth API Reference](https://www.better-auth.com/docs).

0 commit comments

Comments
 (0)