schemas_file.py

# The custom schemas file

from drf_spectacular.utils import OpenApiParameter, extend_schema

list_users_schema = extend_schema(
    parameters=[
        OpenApiParameter(
            name="username",
            description=(
                "Searches for the value in this query parameter returning "
                "all the users that have this value as substring. Ignores lowercase and uppercase."
            ),
            type=str
        )
    ]
)