fastapi-users/docs/configuration/model.md

User model

FastAPI Users defines a minimal User model for authentication purposes. It is structured like this:

• id (str) – Unique identifier of the user. Default to a UUID4.
• email (str) – Email of the user. Validated by email-validator.
• is_active (bool) – Whether or not the user is active. If not, login and forgot password requests will be denied. Default to True.
• is_superuser (bool) – Whether or not the user is a superuser. Useful to implement administration logic. Default to False.

Define your models

There are four Pydantic models variations provided as mixins:

• BaseUser, which provides the basic fields and validation ;
• BaseCreateUser, dedicated to user registration, which makes the email compulsory and adds a compulsory password field ;
• BaseUpdateUser, dedicated to user profile update, which adds an optional password field ;
• BaseUserDB, which is a representation of the user in database, adding a hashed_password field.

You should define each of those variations, inheriting from each mixin:

from fastapi_users import models


class User(models.BaseUser):
    pass


class UserCreate(User, models.BaseUserCreate):
    pass


class UserUpdate(User, models.BaseUserUpdate):
    pass


class UserDB(User, models.BaseUserDB):
    pass

You can of course add you own properties there to fit to your needs!

Next steps

Depending on your database backend, database configuration will differ a bit.

I'm using SQLAlchemy

I'm using MongoDB

I'm using Tortoise ORM