Skip to main content

Path

Declare a path parameter for a path operation.

def Path(
default: Any = ...,
default_factory: Callable[[], Any] | None = _Unset,
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] | None = None,
deprecated: deprecated | str | bool | None = None,
include_in_schema: bool = True,
json_schema_extra: dict[str, Any] | None = None
) - > Any

Declare a path parameter for a path operation.

Parameters

NameTypeDescription
defaultAny = ...Default value if the parameter field is not set. This doesn't affect Path parameters as the value is always required; it is available only for compatibility.
default_factory`Callable[[], Any]None` = _Unset
alias`strNone` = None
alias_priority`intNone` = _Unset
validation_alias`strAliasPath
serialization_alias`strNone` = None
title`strNone` = None
description`strNone` = None
gt`floatNone` = None
ge`floatNone` = None
lt`floatNone` = None
le`floatNone` = None
min_length`intNone` = None
max_length`intNone` = None
pattern`strNone` = None
regex`strNone` = None
discriminator`strNone` = None
strict`boolNone` = _Unset
multiple_of`floatNone` = _Unset
allow_inf_nan`boolNone` = _Unset
max_digits`intNone` = _Unset
decimal_places`intNone` = _Unset
examples`list[Any]None` = None
example`AnyNone` = _Unset
openapi_examples`dict[str, Example]None` = None
deprecated`deprecatedstr
include_in_schemabool = TrueWhether to include this parameter field in the generated OpenAPI schema.
json_schema_extra`dict[str, Any]None` = None

Returns

TypeDescription
AnyA path parameter metadata object used by FastAPI for validation and OpenAPI generation.