fastapi-users/docs/configuration/model.md

User model

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

• id (UUID4) – Unique identifier of the user. Defaults 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. Defaults to True.
• is_verified (bool) – Whether or not the user is verified. Optional but helpful with the verify router logic. Defaults to False.
• is_superuser (bool) – Whether or not the user is a superuser. Useful to implement administration logic. Defaults 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 consists of compulsory email and password fields ;
• 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(models.BaseUserCreate):
    pass


class UserUpdate(User, models.BaseUserUpdate):
    pass


class UserDB(User, models.BaseUserDB):
    pass

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

Next steps

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

I'm using SQLAlchemy

I'm using MongoDB

I'm using Tortoise ORM

I'm using ormar