Skip to main content

POST /utils/

Create new user.

Registers a new user in the system and optionally sends a welcome email if configured. This endpoint is restricted to superuser accounts.

Endpoint

POST /utils/

Parameters

NameTypeDescription
sessionSessionDepThe database session dependency used for persistence operations.
user_inUserCreateThe data transfer object containing the new user's email, password, and profile details.

Request Body

FieldTypeDescription
emailstringThe email address for the new user account, used for login and notifications.
passwordstringThe plain text password to be hashed and stored for the new user.
full_namestringThe optional full name of the user.

Response

StatusDescription
200The user was successfully created. Returns UserPublic.
400Returned when a user with the provided email address already exists in the system. Returns HTTPException.
401Returned when the request lacks valid authentication credentials.
403Returned when the authenticated user does not have superuser privileges.