Configuration property fixed at build time - All other configuration properties are overridable at runtime

Configuration property

Type

Default

Whether to skip the generation of models for form parameters

Environment variable: QUARKUS_OPENAPI_GENERATOR_CODEGEN_SKIP_FORM_MODEL

boolean

Type Mapping is an OpenAPI Generator configuration specifying which Java types (the values) should be used for a given OAS datatype (the keys of this map)

Environment variable: QUARKUS_OPENAPI_GENERATOR_CODEGEN_TYPE_MAPPINGS__TYPE_MAPPINGS_

Map<String,String>

Import Mapping is an OpenAPI Generator configuration specifying which Java types (the values) should be imported when a given OAS datatype (the keys of this map) is used

Environment variable: QUARKUS_OPENAPI_GENERATOR_CODEGEN_IMPORT_MAPPINGS__IMPORT_MAPPINGS_

Map<String,String>

Schema Mapping is an OpenAPI Generator configuration specifying which Java types (the values) should be imported when a given schema type (the keys of this map) is used

Environment variable: QUARKUS_OPENAPI_GENERATOR_CODEGEN_SCHEMA_MAPPINGS__SCHEMA_MAPPINGS_

Map<String,String>

The specified annotations will be added to the generated model files

Environment variable: QUARKUS_OPENAPI_GENERATOR_CODEGEN_ADDITIONAL_MODEL_TYPE_ANNOTATIONS

string

Defines if the enums should have an UNEXPECTED member to convey values that cannot be parsed. Default is false.

Environment variable: QUARKUS_OPENAPI_GENERATOR_CODEGEN_ADDITIONAL_ENUM_TYPE_UNEXPECTED_MEMBER

boolean

The specified annotations will be added to the generated api files

Environment variable: QUARKUS_OPENAPI_GENERATOR_CODEGEN_ADDITIONAL_API_TYPE_ANNOTATIONS

string

Add custom/additional HTTP Headers or other args to every request

Environment variable: QUARKUS_OPENAPI_GENERATOR_CODEGEN_ADDITIONAL_REQUEST_ARGS

string

Defines if the methods should return jakarta.ws.rs.core.Response or a model. Default is false.

Environment variable: QUARKUS_OPENAPI_GENERATOR_CODEGEN_RETURN_RESPONSE

boolean

Defines if security support classes should be generated

Environment variable: QUARKUS_OPENAPI_GENERATOR_CODEGEN_ENABLE_SECURITY_GENERATION

string

Defines the normalizer options.

Environment variable: QUARKUS_OPENAPI_GENERATOR_CODEGEN_OPEN_API_NORMALIZER__NORMALIZER_

Map<String,String>

Enable SmallRye Mutiny support. If you set this to true, all return types will be wrapped in io.smallrye.mutiny.Uni.

Environment variable: QUARKUS_OPENAPI_GENERATOR_CODEGEN_MUTINY

boolean

Defines with SmallRye Mutiny enabled if methods should return jakarta.ws.rs.core.Response or a model. Default is false.

Environment variable: QUARKUS_OPENAPI_GENERATOR_CODEGEN_MUTINY_RETURN_RESPONSE

boolean

Handles the return type for each operation, depending on the configuration. The following cases are supported:

  1. If mutiny is enabled and the operation ID is specified to return Multi: - The return type will be wrapped in io.smallrye.mutiny.Multi. - If mutiny.return-response is enabled, the return type will be io.smallrye.mutiny.Multi<jakarta.ws.rs.core.Response>. - If the operation has a void return type, it will return io.smallrye.mutiny.Multi<jakarta.ws.rs.core.Response>. - Otherwise, it will return io.smallrye.mutiny.Multi<returnType>.

  2. If mutiny is enabled and the operation ID is specified to return Uni: - The return type will be wrapped in io.smallrye.mutiny.Uni. - If mutiny.return-response is enabled, the return type will be io.smallrye.mutiny.Uni<jakarta.ws.rs.core.Response>. - If the operation has a void return type, it will return io.smallrye.mutiny.Uni<jakarta.ws.rs.core.Response>. - Otherwise, it will return io.smallrye.mutiny.Uni<returnType>.

  3. If mutiny is enabled but no specific operation ID is configured for Multi or Uni: - The return type defaults to Uni. - If mutiny.return-response is enabled, the return type will be io.smallrye.mutiny.Uni<jakarta.ws.rs.core.Response>. - If the operation has a void return type, it will return io.smallrye.mutiny.Uni<jakarta.ws.rs.core.Response>. - Otherwise, it will return io.smallrye.mutiny.Uni<returnType>`.

Environment variable: QUARKUS_OPENAPI_GENERATOR_CODEGEN_MUTINY_OPERATION_IDS__MUTINY_MULTI_OPERATION_IDS_

Map<String,String>

Defines, whether the PartFilename (org.jboss.resteasy.reactive.PartFilename or org.jboss.resteasy.annotations.providers.multipart.PartFilename) annotation should be generated for MultipartForm POJOs. By setting to false, the annotation will not be generated.

Environment variable: QUARKUS_OPENAPI_GENERATOR_CODEGEN_GENERATE_PART_FILENAME

boolean

Defines the filename for a part in case the PartFilename annotation (org.jboss.resteasy.reactive.PartFilename or org.jboss.resteasy.annotations.providers.multipart.PartFilename) is generated. In case no value is set, the default one is <fieldName>File or file, depending on the CommonItemConfig#useFieldNameInPartFilename configuration.

Environment variable: QUARKUS_OPENAPI_GENERATOR_CODEGEN_PART_FILENAME_VALUE

string

Defines, whether the filename should also include the property name in case the PartFilename annotation (org.jboss.resteasy.reactive.PartFilename or org.jboss.resteasy.annotations.providers.multipart.PartFilename) is generated.

Environment variable: QUARKUS_OPENAPI_GENERATOR_CODEGEN_USE_FIELD_NAME_IN_PART_FILENAME

boolean

Enable bean validation. If you set this to true, validation annotations are added to generated sources E.g. @Size.

Environment variable: QUARKUS_OPENAPI_GENERATOR_CODEGEN_USE_BEAN_VALIDATION

boolean

Enable the generation of APIs. If you set this to false, APIs will not be generated.

Environment variable: QUARKUS_OPENAPI_GENERATOR_CODEGEN_GENERATE_APIS

boolean

Enable the generation of models. If you set this to false, models will not be generated.

Environment variable: QUARKUS_OPENAPI_GENERATOR_CODEGEN_GENERATE_MODELS

boolean

Enable the generation of equals and hashcode in models. If you set this to false, the models will not have equals and hashcode.

Environment variable: QUARKUS_OPENAPI_GENERATOR_CODEGEN_EQUALS_HASHCODE

boolean

Add additional properties as attribute.

Environment variable: QUARKUS_OPENAPI_GENERATOR_CODEGEN_ADDITIONAL_PROPERTIES_AS_ATTRIBUTE

string

Initialise collections as empty instead of null

Environment variable: QUARKUS_OPENAPI_GENERATOR_CODEGEN_INITIALIZE_EMPTY_COLLECTIONS

string

Whether to log the internal generator codegen process in the default output or not.

Environment variable: QUARKUS_OPENAPI_GENERATOR_CODEGEN_VERBOSE

boolean

false

Option to change the directory where OpenAPI files must be found.

Environment variable: QUARKUS_OPENAPI_GENERATOR_CODEGEN_INPUT_BASE_DIR

string

Option to change the directory where template files must be found.

Environment variable: QUARKUS_OPENAPI_GENERATOR_CODEGEN_TEMPLATE_BASE_DIR

string

Whether or not to skip validating the input spec prior to generation. By default, invalid specifications will result in an error.

Environment variable: QUARKUS_OPENAPI_GENERATOR_CODEGEN_VALIDATESPEC

boolean

true

Option to specify files for which generation should be executed only

Environment variable: QUARKUS_OPENAPI_GENERATOR_CODEGEN_INCLUDE

string

Option to exclude file from generation

Environment variable: QUARKUS_OPENAPI_GENERATOR_CODEGEN_EXCLUDE

string

Create security for the referenced security scheme

Environment variable: QUARKUS_OPENAPI_GENERATOR_CODEGEN_DEFAULT_SECURITY_SCHEME

string

Whether to skip the generation of models for form parameters

Environment variable: QUARKUS_OPENAPI_GENERATOR_CODEGEN_SPEC__SPEC_ITEM__SKIP_FORM_MODEL

boolean

Type Mapping is an OpenAPI Generator configuration specifying which Java types (the values) should be used for a given OAS datatype (the keys of this map)

Environment variable: QUARKUS_OPENAPI_GENERATOR_CODEGEN_SPEC__SPEC_ITEM__TYPE_MAPPINGS__TYPE_MAPPINGS_

Map<String,String>

Import Mapping is an OpenAPI Generator configuration specifying which Java types (the values) should be imported when a given OAS datatype (the keys of this map) is used

Environment variable: QUARKUS_OPENAPI_GENERATOR_CODEGEN_SPEC__SPEC_ITEM__IMPORT_MAPPINGS__IMPORT_MAPPINGS_

Map<String,String>

Schema Mapping is an OpenAPI Generator configuration specifying which Java types (the values) should be imported when a given schema type (the keys of this map) is used

Environment variable: QUARKUS_OPENAPI_GENERATOR_CODEGEN_SPEC__SPEC_ITEM__SCHEMA_MAPPINGS__SCHEMA_MAPPINGS_

Map<String,String>

The specified annotations will be added to the generated model files

Environment variable: QUARKUS_OPENAPI_GENERATOR_CODEGEN_SPEC__SPEC_ITEM__ADDITIONAL_MODEL_TYPE_ANNOTATIONS

string

Defines if the enums should have an UNEXPECTED member to convey values that cannot be parsed. Default is false.

Environment variable: QUARKUS_OPENAPI_GENERATOR_CODEGEN_SPEC__SPEC_ITEM__ADDITIONAL_ENUM_TYPE_UNEXPECTED_MEMBER

boolean

The specified annotations will be added to the generated api files

Environment variable: QUARKUS_OPENAPI_GENERATOR_CODEGEN_SPEC__SPEC_ITEM__ADDITIONAL_API_TYPE_ANNOTATIONS

string

Add custom/additional HTTP Headers or other args to every request

Environment variable: QUARKUS_OPENAPI_GENERATOR_CODEGEN_SPEC__SPEC_ITEM__ADDITIONAL_REQUEST_ARGS

string

Defines if the methods should return jakarta.ws.rs.core.Response or a model. Default is false.

Environment variable: QUARKUS_OPENAPI_GENERATOR_CODEGEN_SPEC__SPEC_ITEM__RETURN_RESPONSE

boolean

Defines if security support classes should be generated

Environment variable: QUARKUS_OPENAPI_GENERATOR_CODEGEN_SPEC__SPEC_ITEM__ENABLE_SECURITY_GENERATION

string

Defines the normalizer options.

Environment variable: QUARKUS_OPENAPI_GENERATOR_CODEGEN_SPEC__SPEC_ITEM__OPEN_API_NORMALIZER__NORMALIZER_

Map<String,String>

Enable SmallRye Mutiny support. If you set this to true, all return types will be wrapped in io.smallrye.mutiny.Uni.

Environment variable: QUARKUS_OPENAPI_GENERATOR_CODEGEN_SPEC__SPEC_ITEM__MUTINY

boolean

Defines with SmallRye Mutiny enabled if methods should return jakarta.ws.rs.core.Response or a model. Default is false.

Environment variable: QUARKUS_OPENAPI_GENERATOR_CODEGEN_SPEC__SPEC_ITEM__MUTINY_RETURN_RESPONSE

boolean

Handles the return type for each operation, depending on the configuration. The following cases are supported:

  1. If mutiny is enabled and the operation ID is specified to return Multi: - The return type will be wrapped in io.smallrye.mutiny.Multi. - If mutiny.return-response is enabled, the return type will be io.smallrye.mutiny.Multi<jakarta.ws.rs.core.Response>. - If the operation has a void return type, it will return io.smallrye.mutiny.Multi<jakarta.ws.rs.core.Response>. - Otherwise, it will return io.smallrye.mutiny.Multi<returnType>.

  2. If mutiny is enabled and the operation ID is specified to return Uni: - The return type will be wrapped in io.smallrye.mutiny.Uni. - If mutiny.return-response is enabled, the return type will be io.smallrye.mutiny.Uni<jakarta.ws.rs.core.Response>. - If the operation has a void return type, it will return io.smallrye.mutiny.Uni<jakarta.ws.rs.core.Response>. - Otherwise, it will return io.smallrye.mutiny.Uni<returnType>.

  3. If mutiny is enabled but no specific operation ID is configured for Multi or Uni: - The return type defaults to Uni. - If mutiny.return-response is enabled, the return type will be io.smallrye.mutiny.Uni<jakarta.ws.rs.core.Response>. - If the operation has a void return type, it will return io.smallrye.mutiny.Uni<jakarta.ws.rs.core.Response>. - Otherwise, it will return io.smallrye.mutiny.Uni<returnType>`.

Environment variable: QUARKUS_OPENAPI_GENERATOR_CODEGEN_SPEC__SPEC_ITEM__MUTINY_OPERATION_IDS__MUTINY_MULTI_OPERATION_IDS_

Map<String,String>

Defines, whether the PartFilename (org.jboss.resteasy.reactive.PartFilename or org.jboss.resteasy.annotations.providers.multipart.PartFilename) annotation should be generated for MultipartForm POJOs. By setting to false, the annotation will not be generated.

Environment variable: QUARKUS_OPENAPI_GENERATOR_CODEGEN_SPEC__SPEC_ITEM__GENERATE_PART_FILENAME

boolean

Defines the filename for a part in case the PartFilename annotation (org.jboss.resteasy.reactive.PartFilename or org.jboss.resteasy.annotations.providers.multipart.PartFilename) is generated. In case no value is set, the default one is <fieldName>File or file, depending on the CommonItemConfig#useFieldNameInPartFilename configuration.

Environment variable: QUARKUS_OPENAPI_GENERATOR_CODEGEN_SPEC__SPEC_ITEM__PART_FILENAME_VALUE

string

Defines, whether the filename should also include the property name in case the PartFilename annotation (org.jboss.resteasy.reactive.PartFilename or org.jboss.resteasy.annotations.providers.multipart.PartFilename) is generated.

Environment variable: QUARKUS_OPENAPI_GENERATOR_CODEGEN_SPEC__SPEC_ITEM__USE_FIELD_NAME_IN_PART_FILENAME

boolean

Enable bean validation. If you set this to true, validation annotations are added to generated sources E.g. @Size.

Environment variable: QUARKUS_OPENAPI_GENERATOR_CODEGEN_SPEC__SPEC_ITEM__USE_BEAN_VALIDATION

boolean

Enable the generation of APIs. If you set this to false, APIs will not be generated.

Environment variable: QUARKUS_OPENAPI_GENERATOR_CODEGEN_SPEC__SPEC_ITEM__GENERATE_APIS

boolean

Enable the generation of models. If you set this to false, models will not be generated.

Environment variable: QUARKUS_OPENAPI_GENERATOR_CODEGEN_SPEC__SPEC_ITEM__GENERATE_MODELS

boolean

Enable the generation of equals and hashcode in models. If you set this to false, the models will not have equals and hashcode.

Environment variable: QUARKUS_OPENAPI_GENERATOR_CODEGEN_SPEC__SPEC_ITEM__EQUALS_HASHCODE

boolean

Add additional properties as attribute.

Environment variable: QUARKUS_OPENAPI_GENERATOR_CODEGEN_SPEC__SPEC_ITEM__ADDITIONAL_PROPERTIES_AS_ATTRIBUTE

string

Initialise collections as empty instead of null

Environment variable: QUARKUS_OPENAPI_GENERATOR_CODEGEN_SPEC__SPEC_ITEM__INITIALIZE_EMPTY_COLLECTIONS

string

Base package for where the generated code for the given OpenAPI specification will be added.

Environment variable: QUARKUS_OPENAPI_GENERATOR_CODEGEN_SPEC__SPEC_ITEM__BASE_PACKAGE

string

Custom config key to use in place of the openapi spec file

Environment variable: QUARKUS_OPENAPI_GENERATOR_CODEGEN_SPEC__SPEC_ITEM__CONFIG_KEY

string

Suffix name for generated api classes

Environment variable: QUARKUS_OPENAPI_GENERATOR_CODEGEN_SPEC__SPEC_ITEM__API_NAME_SUFFIX

string

Suffix name for generated model classes

Environment variable: QUARKUS_OPENAPI_GENERATOR_CODEGEN_SPEC__SPEC_ITEM__MODEL_NAME_SUFFIX

string

Prefix name for generated model classes

Environment variable: QUARKUS_OPENAPI_GENERATOR_CODEGEN_SPEC__SPEC_ITEM__MODEL_NAME_PREFIX

string

Remove operation id prefix

Environment variable: QUARKUS_OPENAPI_GENERATOR_CODEGEN_SPEC__SPEC_ITEM__REMOVE_OPERATION_ID_PREFIX

boolean

Remove operation id prefix

Environment variable: QUARKUS_OPENAPI_GENERATOR_CODEGEN_SPEC__SPEC_ITEM__REMOVE_OPERATION_ID_PREFIX_DELIMITER

string

Remove operation id prefix

Environment variable: QUARKUS_OPENAPI_GENERATOR_CODEGEN_SPEC__SPEC_ITEM__REMOVE_OPERATION_ID_PREFIX_COUNT

int

Set serializable model

Environment variable: QUARKUS_OPENAPI_GENERATOR_CODEGEN_SPEC__SPEC_ITEM__SERIALIZABLE_MODEL

boolean

Whether to enable Dynamic URLs on APIs methods. By enabling this property every method on RestClients will be annotated with io.quarkus.rest.client.reactive.Url.

Environment variable: QUARKUS_OPENAPI_GENERATOR_CODEGEN_SPEC__SPEC_ITEM__USE_DYNAMIC_URL

boolean

false

Enables the authentication token propagation for this particular securityScheme.

For example, given a file named petstore.json with a securityScheme named "petstore-auth" the following configuration must be used.

quarkus.openapi-generator.petstore_json.auth.petstore_auth.token-propagation=true

Environment variable: QUARKUS_OPENAPI_GENERATOR__ITEM_CONFIGS__AUTH__AUTH_CONFIGS__TOKEN_PROPAGATION

boolean

Configures a particular http header attribute from were to take the security token from when the token propagation is enabled. Use this fine-grained configuration in very particular scenarios.

For example, given a file named petstore.json with a securityScheme named "petstore-auth" the following configuration must be used.

quarkus.openapi-generator.petstore_json.auth.petstore_auth.header-name=MyParticularHttpHeaderName

Environment variable: QUARKUS_OPENAPI_GENERATOR__ITEM_CONFIGS__AUTH__AUTH_CONFIGS__HEADER_NAME

string

Sets the Basic Authentication username for a given OpenAPI securityScheme.

For example, given a file named petstore.json with a securityScheme named "petstore-basic-auth", that is of http basic authentication type, the following configuration can establish the user to be used.

quarkus.openapi-generator.petstore_json.auth.petstore_basic_auth.username=MyUserName

Environment variable: QUARKUS_OPENAPI_GENERATOR__ITEM_CONFIGS__AUTH__AUTH_CONFIGS__USERNAME

string

Sets the Basic Authentication password for a given OpenAPI securityScheme.

For example, given a file named petstore.json with a securityScheme named "petstore-basic-auth", that is of http basic authentication type, the following configuration can establish the password to be used.

quarkus.openapi-generator.petstore_json.auth.petstore_basic_auth.password=MyPassword

Ignored if the given securityScheme is not Basic Authentication

Environment variable: QUARKUS_OPENAPI_GENERATOR__ITEM_CONFIGS__AUTH__AUTH_CONFIGS__PASSWORD

string

Sets the Bearer Token for a given OpenAPI securityScheme.

For example, given a file named petstore.json with a securityScheme named "petstore-bearer-auth", that is of bearer authentication type, the following configuration can establish the token to be used.

quarkus.openapi-generator.petstore_json.auth.petstore_bearer_auth.token=1234567890

Ignored if the given securityScheme is not Bearer Token Authentication

Environment variable: QUARKUS_OPENAPI_GENERATOR__ITEM_CONFIGS__AUTH__AUTH_CONFIGS__BEARER_TOKEN

string

Sets the API Key for a given OpenAPI securityScheme.

For example, given a file named petstore.json with a securityScheme named "petstore-apikey-auth", that is of API Key authentication type, the following configuration can establish the API Key to be used.

quarkus.openapi-generator.petstore_json.auth.petstore_apikey_auth.api-key=${MY_SECRET_KEY_IN_AN_ENV_VAR}

Ignored if the given securityScheme is not API Key Authentication

Environment variable: QUARKUS_OPENAPI_GENERATOR__ITEM_CONFIGS__AUTH__AUTH_CONFIGS__API_KEY

string

Only valid for API Key Authentication.

When to add the Authorization value to the API Key in the authentication header.

For example, if this property is set to true, the API Key will be sent to the server in the header along with Authorization:

[source] --- Authentication: Authorization MY-API-KEY ---

If set to false, the header should be:

[source] --- Authentication: MY-API-KEY ---

Environment variable: QUARKUS_OPENAPI_GENERATOR__ITEM_CONFIGS__AUTH__AUTH_CONFIGS__USE_AUTHORIZATION_HEADER_VALUE

boolean