File

This class represents a file upload in a web request, extending form data functionality to handle binary content. It allows for the definition of file-specific metadata, validation constraints, and OpenAPI schema documentation. By default, it configures the media type to multipart/form-data to facilitate standard file transfers.

Attributes

Attribute	Type	Description
media_type	string = "multipart/form-data"	The media type used to define the content type of the file upload, defaulting to multipart/form-data.

---

Constructor

Signature

def File(
    default: Any = Undefined,
    default_factory: Callable[[], Any]| None = _Unset,
    annotation: Any | None = None,
    media_type: str = "multipart/form-data",
    alias: str | None = None,
    alias_priority: int | None = _Unset,
    validation_alias: str | AliasPath | AliasChoices | None = None,
    serialization_alias: str | None = None,
    title: str | None = None,
    description: str | None = None,
    gt: float | None = None,
    ge: float | None = None,
    lt: float | None = None,
    le: float | None = None,
    min_length: int | None = None,
    max_length: int | None = None,
    pattern: str | None = None,
    regex: str | None = None,
    discriminator: str | None = None,
    strict: bool | None = _Unset,
    multiple_of: float | None = _Unset,
    allow_inf_nan: bool | None = _Unset,
    max_digits: int | None = _Unset,
    decimal_places: int | None = _Unset,
    examples: list[Any]| None = None,
    example: Any | None = _Unset,
    openapi_examples: dict[str, [Example](../openapi/models/example.md?sid=fastapi_openapi_models_example)]| None = None,
    deprecated: deprecated | str | bool | None = None,
    include_in_schema: bool = True,
    json_schema_extra: dict[str, Any]| None = None,
    **extra: Any
)

Parameters

Name	Type	Description
default	Any = Undefined	The default value for the field.
default_factory	`Callable[[], Any]	None` = _Unset
annotation	`Any	None` = None
media_type	str = "multipart/form-data"	The media type for the file upload.
alias	`str	None` = None
alias_priority	`int	None` = _Unset
validation_alias	`str	AliasPath
serialization_alias	`str	None` = None
title	`str	None` = None
description	`str	None` = None
gt	`float	None` = None
ge	`float	None` = None
lt	`float	None` = None
le	`float	None` = None
min_length	`int	None` = None
max_length	`int	None` = None
pattern	`str	None` = None
regex	`str	None` = None
discriminator	`str	None` = None
strict	`bool	None` = _Unset
multiple_of	`float	None` = _Unset
allow_inf_nan	`bool	None` = _Unset
max_digits	`int	None` = _Unset
decimal_places	`int	None` = _Unset
examples	`list[Any]	None` = None
example	`Any	None` = _Unset
openapi_examples	`dict[str, Example]	None` = None
deprecated	`deprecated	str
include_in_schema	bool = True	Whether to include this field in the OpenAPI schema.
json_schema_extra	`dict[str, Any]	None` = None
**extra	Any	Additional keyword arguments.

---

Signature

def File(
    default: Any = Undefined,
    default_factory: Callable[[], Any]| None = _Unset,
    annotation: Any | None = None,
    media_type: str = "multipart/form-data",
    alias: str | None = None,
    alias_priority: int | None = _Unset,
    validation_alias: str | AliasPath | AliasChoices | None = None,
    serialization_alias: str | None = None,
    title: str | None = None,
    description: str | None = None,
    gt: float | None = None,
    ge: float | None = None,
    lt: float | None = None,
    le: float | None = None,
    min_length: int | None = None,
    max_length: int | None = None,
    pattern: str | None = None,
    regex: str | None = None,
    discriminator: str | None = None,
    strict: bool | None = _Unset,
    multiple_of: float | None = _Unset,
    allow_inf_nan: bool | None = _Unset,
    max_digits: int | None = _Unset,
    decimal_places: int | None = _Unset,
    examples: list[Any]| None = None,
    example: Any | None = _Unset,
    openapi_examples: dict[str, [Example](../openapi/models/example.md?sid=fastapi_openapi_models_example)]| None = None,
    deprecated: deprecated | str | bool | None = None,
    include_in_schema: bool = True,
    json_schema_extra: dict[str, Any]| None = None,
    **extra: Any
)

Parameters

Name	Type	Description
default	Any = Undefined	The default value for the file field if none is provided in the request.
default_factory	`Callable[[], Any]	None` = _Unset
annotation	`Any	None` = None
media_type	str = "multipart/form-data"	The content type for the request body, defaulting to multipart/form-data for file uploads.
alias	`str	None` = None
alias_priority	`int	None` = _Unset
validation_alias	`str	AliasPath
serialization_alias	`str	None` = None
title	`str	None` = None
description	`str	None` = None
gt	`float	None` = None
ge	`float	None` = None
lt	`float	None` = None
le	`float	None` = None
min_length	`int	None` = None
max_length	`int	None` = None
pattern	`str	None` = None
regex	`str	None` = None
discriminator	`str	None` = None
strict	`bool	None` = _Unset
multiple_of	`float	None` = _Unset
allow_inf_nan	`bool	None` = _Unset
max_digits	`int	None` = _Unset
decimal_places	`int	None` = _Unset
examples	`list[Any]	None` = None
example	`Any	None` = _Unset
openapi_examples	`dict[str, Example]	None` = None
deprecated	`deprecated	str
include_in_schema	bool = True	Whether to include this parameter in the generated OpenAPI schema.
json_schema_extra	`dict[str, Any]	None` = None
**extra	Any	Additional keyword arguments passed to the parent Form class.

---