Skip to content
OTA-Pulse Docs

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.

Does NOT issue a session — the account is unverified until the emailed link is confirmed (POST /auth/verify-email), and login is blocked until then. Immediately logging in an unverified user would just recreate the same confusing half-state this gate exists to avoid.

Request Body required

User registration request

object
email
required
string format: email
full_name
Any of:
string
<= 255 characters
organization_name
Any of:
string
<= 255 characters
password
required
string
>= 8 characters <= 128 characters
username
required
string
>= 3 characters <= 50 characters /^[a-zA-Z0-9_-]+$/

Responses

201

Successful Response

422

Validation Error

object
detail
Array<object>
object
loc
required
Array
msg
required
string
type
required
string