Skip to content

Bootstrap the first local platform admin before any local user exists.

POST
/v1/local-identity/bootstrap-admin

Allowed only before first local user exists, only when auth_mode=local_identity, and only when the one-time bootstrap token header matches backend configuration. Returns a generated temporary password once when password is omitted.

x-gateway-local-bootstrap-token
required
string
>= 1 characters

One-time bootstrap token sourced from a Secret/env var; never returned.

object
user_id
string
>= 1 characters
display_name
string
>= 1 characters
email
string format: email
password
string
>= 12 characters

Local platform admin bootstrapped.

object
schema_version
required
status
required
Allowed values: completed
user
required
object
user_id
required
string
>= 1 characters
display_name
required
string
>= 1 characters
email
string format: email
status
required
Allowed values: active disabled
created_at
required
string
disabled_at
string
last_login_at
string
password_reset_required
required
boolean
groups
required
Array<string>
group
required
object
group_id
required
string
>= 1 characters
display_name
required
string
>= 1 characters
created_at
required
string
disabled_at
string
members
required
Array<string>
temporary_password

Returned once only when generated by the backend.

string
>= 12 characters

Type set in Geist, Source Serif 4, and Departure Mono.