Cookie

This class represents a cookie parameter in an API request, inheriting from the base parameter class to handle data extraction from browser cookies. It provides extensive support for validation, metadata documentation, and OpenAPI schema customization, including constraints like length limits and numeric ranges. The class also manages aliases and deprecation notices to ensure flexible integration with various data models and API versions.

Attributes

Attribute	Type	Description
in_	[ParamTypes](paramtypes.md?sid=fastapi_params_paramtypes) = ParamTypes.cookie	The location of the parameter in the request, specifically set to indicate it is a cookie value.

---

Constructor

Signature

def Cookie(
    default: Any = Undefined,
    default_factory: Callable[[], Any]| None = _Unset,
    annotation: Any | None = None,
    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 cookie.
default_factory	`Callable[[], Any]	None` = _Unset
annotation	`Any	None` = None
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.

---

Signature

def Cookie(
    default: Any = Undefined,
    default_factory: Callable[[], Any]| None = _Unset,
    annotation: Any | None = null,
    alias: str | None = null,
    alias_priority: int | None = _Unset,
    validation_alias: str | AliasPath | AliasChoices | None = null,
    serialization_alias: str | None = null,
    title: str | None = null,
    description: str | None = null,
    gt: float | None = null,
    ge: float | None = null,
    lt: float | None = null,
    le: float | None = null,
    min_length: int | None = null,
    max_length: int | None = null,
    pattern: str | None = null,
    regex: str | None = null,
    discriminator: str | None = null,
    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 = null,
    example: Any | None = _Unset,
    openapi_examples: dict[str, [Example](../openapi/models/example.md?sid=fastapi_openapi_models_example)]| None = null,
    deprecated: deprecated | str | bool | None = null,
    include_in_schema: bool = True,
    json_schema_extra: dict[str, Any]| None = null,
    extra: Any
)

Parameters

Name	Type	Description
default	Any = Undefined	The default value for the cookie if none is provided in the request.
default_factory	`Callable[[], Any]	None` = _Unset
annotation	`Any	None` = null
alias	`str	None` = null
alias_priority	`int	None` = _Unset
validation_alias	`str	AliasPath
serialization_alias	`str	None` = null
title	`str	None` = null
description	`str	None` = null
gt	`float	None` = null
ge	`float	None` = null
lt	`float	None` = null
le	`float	None` = null
min_length	`int	None` = null
max_length	`int	None` = null
pattern	`str	None` = null
regex	`str	None` = null
discriminator	`str	None` = null
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` = null
example	`Any	None` = _Unset
openapi_examples	`dict[str, Example]	None` = null
deprecated	`deprecated	str
include_in_schema	bool = True	Whether to include this cookie parameter in the generated OpenAPI schema.
json_schema_extra	`dict[str, Any]	None` = null
extra	Any	Additional keyword arguments passed to the underlying Pydantic field configuration.

---