Skip to main content

PathItem

This class represents a Path Item object in an OpenAPI specification, defining the available operations for a specific endpoint path. It supports various HTTP methods such as GET, POST, and PUT, while allowing for shared metadata like summaries, descriptions, and parameters across those operations. The class also facilitates external references and server-specific configurations for the defined path.

Attributes

AttributeTypeDescription
refstring = nullAn external reference to a path item definition, used to populate this object's fields.
summarystring = nullAn optional, short summary intended to apply to all operations in this path.
descriptionstring = nullAn optional, verbose explanation of the path item which can use CommonMark syntax.
get[Operation](operation.md?sid=fastapi_openapi_models_operation) = nullThe definition of a GET operation on this path.
put[Operation](operation.md?sid=fastapi_openapi_models_operation) = nullThe definition of a PUT operation on this path.
post[Operation](operation.md?sid=fastapi_openapi_models_operation) = nullThe definition of a POST operation on this path.
delete[Operation](operation.md?sid=fastapi_openapi_models_operation) = nullThe definition of a DELETE operation on this path.
options[Operation](operation.md?sid=fastapi_openapi_models_operation) = nullThe definition of an OPTIONS operation on this path.
head[Operation](operation.md?sid=fastapi_openapi_models_operation) = nullThe definition of a HEAD operation on this path.
patch[Operation](operation.md?sid=fastapi_openapi_models_operation) = nullThe definition of a PATCH operation on this path.
trace[Operation](operation.md?sid=fastapi_openapi_models_operation) = nullThe definition of a TRACE operation on this path.
serverslist[[Server](server.md?sid=fastapi_openapi_models_server)] = nullAn alternative server array to service all operations in this path.
parameters`list[ParameterReference]` = null