Register

POST

/api/auth/register

Register a new user account.

Gated by settings.allow_registration. When False (the default in staging/production), public self-signup is closed — only the seeded admin can create additional users via the admin API.

Request Body ^required

User registration request

object

email

required

string format: email

full_name

Any of:

string

string

<= 255 characters

null

null

organization_name

Any of:

string

string

<= 255 characters

null

null

password

required

string

>= 8 characters <= 128 characters

username

required

string

>= 3 characters <= 50 characters /^[a-zA-Z0-9_-]+$/

Responses

201

Successful Response

JWT token response

object

access_token

required

string

expires_in

required

integer

refresh_token

required

string

token_type

string

default: bearer

user

required

User response schema

object

created_at

required

string format: date-time

email

required

string

full_name

required

Any of:

string

string

null

null

id

required

string format: uuid

is_active

required

boolean

is_superuser

boolean

is_verified

required

boolean

last_login

required

Any of:

string

string format: date-time

null

null

organization_id

Any of:

string

string format: uuid

null

null

timezone

Any of:

string

string

null

null

username

required

string

422

Validation Error

object

detail

Array<object>

object

loc

required

Array

msg

required

string

type

required

string