Inline schemas are schemas defined within a component, such as parameter, requestBody, response, and so on, but are not declared globally in the components/schemas section.
In general, inline schemas are not encouraged in code generators and API portal generators since their names are inferred from the parent node in which they are defined inline.
Names inferred in this manner may not be user-friendly and may conflict with other names resulting in name duplications. As a result, it is recommended that the schemas be defined globally in the components/schemas section with unique names and be used as references throughout the specification.
Inline schemas are schemas defined within a component, such as parameter, requestBody, response, and so on, but are not declared globally in the components/schemas section.
In general, inline schemas are not encouraged in code generators and API portal generators since their names are inferred from the parent node in which they are defined inline.
Names inferred in this manner may not be user-friendly and may conflict with other names resulting in name duplications. As a result, it is recommended that the schemas be defined globally in the components/schemas section with unique names and be used as references throughout the specification.
ref: OpenAPI Best Practices by APIMatic, 3rd point