Config Options for openapi-yaml

These options may be applied as additional-properties (cli) or configOptions (plugins). Refer to configuration docs for more details.

OptionDescriptionValuesDefault
allowUnicodeIdentifiersboolean, toggles whether unicode identifiers are allowed in names or not, default is falsefalse
disallowAdditionalPropertiesIfNotPresentSpecify the behavior when the 'additionalProperties' keyword is not present in the OAS document. If false: the 'additionalProperties' implementation is compliant with the OAS and JSON schema specifications. If true: when the 'additionalProperties' keyword is not present in a schema, the value of 'additionalProperties' is set to false, i.e. no additional properties are allowed. Note: this mode is not compliant with the JSON schema specification. This is the original openapi-generator behavior.This setting is currently ignored for OAS 2.0 documents: 1) When the 'additionalProperties' keyword is not present in a 2.0 schema, additional properties are NOT allowed. 2) Boolean values of the 'additionalProperties' keyword are ignored. It's as if additional properties are NOT allowed.Note: the root cause are issues #1369 and #1371, which must be resolved in the swagger-parser project.
false
The 'additionalProperties' implementation is compliant with the OAS and JSON schema specifications.
true
when the 'additionalProperties' keyword is not present in a schema, the value of 'additionalProperties' is automatically set to false, i.e. no additional properties are allowed. Note: this mode is not compliant with the JSON schema specification. This is the original openapi-generator behavior.
true
ensureUniqueParamsWhether to ensure parameter names are unique in an operation (rename parameters that are not).true
legacyDiscriminatorBehaviorThis flag is used by OpenAPITools codegen to influence the processing of the discriminator attribute in OpenAPI documents. This flag has no impact if the OAS document does not use the discriminator attribute. The default value of this flag is set in each language-specific code generator (e.g. Python, Java, go...)using the method toModelName. Note to developers supporting a language generator in OpenAPITools; to fully support the discriminator attribute as defined in the OAS specification 3.x, language generators should set this flag to true by default; however this requires updating the mustache templates to generate a language-specific discriminator lookup function that iterates over {{#mappedModels}} and does not iterate over {{children}}, {{#anyOf}}, or {{#oneOf}}.
true
The mapping in the discriminator includes descendent schemas that allOf inherit from self and the discriminator mapping schemas in the OAS document.
false
The mapping in the discriminator includes any descendent schemas that allOf inherit from self, any oneOf schemas, any anyOf schemas, any x-discriminator-values, and the discriminator mapping schemas in the OAS document AND Codegen validates that oneOf and anyOf schemas contain the required discriminator and throws an error if the discriminator is missing.
true
outputFileOutput filenameopenapi/openapi.yaml
prependFormOrBodyParametersAdd form or body parameters to the beginning of the parameter list.false
sortModelPropertiesByRequiredFlagSort model properties to place required parameters before optional parameters.true
sortParamsByRequiredFlagSort method arguments to place required parameters before optional parameters.true

IMPORT MAPPING

Type/AliasImports

INSTANTIATION TYPES

Type/AliasInstantiated By

LANGUAGE PRIMITIVES

    RESERVED WORDS

      FEATURE SET

      Client Modification Feature

      NameSupportedDefined By
      BasePathToolingExtension
      AuthorizationsToolingExtension
      UserAgentToolingExtension
      MockServerToolingExtension

      Data Type Feature

      NameSupportedDefined By
      CustomOAS2,OAS3
      Int32OAS2,OAS3
      Int64OAS2,OAS3
      FloatOAS2,OAS3
      DoubleOAS2,OAS3
      DecimalToolingExtension
      StringOAS2,OAS3
      ByteOAS2,OAS3
      BinaryOAS2,OAS3
      BooleanOAS2,OAS3
      DateOAS2,OAS3
      DateTimeOAS2,OAS3
      PasswordOAS2,OAS3
      FileOAS2
      ArrayOAS2,OAS3
      MapsToolingExtension
      CollectionFormatOAS2
      CollectionFormatMultiOAS2
      EnumOAS2,OAS3
      ArrayOfEnumToolingExtension
      ArrayOfModelToolingExtension
      ArrayOfCollectionOfPrimitivesToolingExtension
      ArrayOfCollectionOfModelToolingExtension
      ArrayOfCollectionOfEnumToolingExtension
      MapOfEnumToolingExtension
      MapOfModelToolingExtension
      MapOfCollectionOfPrimitivesToolingExtension
      MapOfCollectionOfModelToolingExtension
      MapOfCollectionOfEnumToolingExtension

      Documentation Feature

      NameSupportedDefined By
      ReadmeToolingExtension
      ModelToolingExtension
      ApiToolingExtension

      Global Feature

      NameSupportedDefined By
      HostOAS2,OAS3
      BasePathOAS2,OAS3
      InfoOAS2,OAS3
      SchemesOAS2,OAS3
      PartialSchemesOAS2,OAS3
      ConsumesOAS2
      ProducesOAS2
      ExternalDocumentationOAS2,OAS3
      ExamplesOAS2,OAS3
      XMLStructureDefinitionsOAS2,OAS3
      MultiServerOAS3
      ParameterizedServerOAS3
      ParameterStylingOAS3
      CallbacksOAS3
      LinkObjectsOAS3

      Parameter Feature

      NameSupportedDefined By
      PathOAS2,OAS3
      QueryOAS2,OAS3
      HeaderOAS2,OAS3
      BodyOAS2
      FormUnencodedOAS2
      FormMultipartOAS2
      CookieOAS3

      Schema Support Feature

      NameSupportedDefined By
      SimpleOAS2,OAS3
      CompositeOAS2,OAS3
      PolymorphismOAS2,OAS3
      UnionOAS3

      Security Feature

      NameSupportedDefined By
      BasicAuthOAS2,OAS3
      ApiKeyOAS2,OAS3
      OpenIDConnectOAS3
      BearerTokenOAS3
      OAuth2_ImplicitOAS2,OAS3
      OAuth2_PasswordOAS2,OAS3
      OAuth2_ClientCredentialsOAS2,OAS3
      OAuth2_AuthorizationCodeOAS2,OAS3

      Wire Format Feature

      NameSupportedDefined By
      JSONOAS2,OAS3
      XMLOAS2,OAS3
      PROTOBUFToolingExtension
      CustomOAS2,OAS3
      Last updated on by patst