Create first admin (one-time setup)

First-run setup: create the first admin user and auto-login.

Unauthenticated by design — there is no admin to authenticate as yet. The operation self-closes once any user exists (returns 410 setup_already_complete thereafter), so it is safe to expose only during first boot.

post/users:create-admin

Request body

emailstring required

first_namestring

last_namestring

passwordstring required

Response

Successful Response

access_tokenstring required

expires_ininteger required

must_change_passwordboolean required

token_typestring required

Changes

Changed in 2 of the 85 revisions of this API.11

Jul 1, 2026d65fcba0d25a1See the full diff
- ○
  endpoint added
  endpoint-added
This revision also has 61 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Apr 13, 202676e8f60637281See the full diff
- ▲
  api path removed without deprecation
  api-path-removed-without-deprecation
This revision also has 179 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

Full history