| allowUnicodeIdentifiers |
boolean, toggles whether unicode identifiers are allowed in names or not, default is false |
|
false |
| apiName |
Must be a valid C# class name. Only used in Generic Host library. Default: Api |
|
Api |
| caseInsensitiveResponseHeaders |
Make API response's headers case-insensitive |
|
false |
| conditionalSerialization |
Serialize only those properties which are initialized by user, accepted values are true or false, default value is false. |
|
false |
| dateFormat |
The default Date format (only generichost library supports this option). |
|
yyyy'-'MM'-'dd |
| dateTimeFormat |
The default DateTime format (only generichost library supports this option). |
|
yyyy'-'MM'-'dd'T'HH':'mm':'ss'.'fffffffK |
| disallowAdditionalPropertiesIfNotPresent |
If false, the 'additionalProperties' implementation (set to true by default) is compliant with the OAS and JSON schema specifications. If true (default), keep the old (incorrect) behaviour that 'additionalProperties' is set to false by default. |
- false
- The 'additionalProperties' implementation is compliant with the OAS and JSON schema specifications.
- true
- Keep the old (incorrect) behaviour that 'additionalProperties' is set to false by default.
|
true |
| equatable |
Overrides Equals and GetHashCode methods. |
|
false |
| hideGenerationTimestamp |
Hides the generation timestamp when files are generated. |
|
true |
| interfacePrefix |
Prefix interfaces with a community standard or widely accepted prefix. |
|
I |
| library |
HTTP library template (sub-template) to use |
- generichost
- HttpClient, Generic Host integration, and System.Text.Json (https://docs.microsoft.com/en-us/dotnet/core/extensions/generic-host)
- httpclient
- HttpClient and Newtonsoft (https://docs.microsoft.com/en-us/dotnet/api/system.net.http.httpclient) (Experimental. Subject to breaking changes without notice.)
- unityWebRequest
- UnityWebRequest (...) (Experimental. Subject to breaking changes without notice.)
- restsharp
- RestSharp (https://github.com/restsharp/RestSharp)
|
generichost |
| licenseId |
The identifier of the license |
|
null |
| modelPropertyNaming |
Naming convention for the property: 'camelCase', 'PascalCase', 'snake_case' and 'original', which keeps the original name |
|
PascalCase |
| modelPropertySorting |
One of legacy, alphabetical, default. |
|
default |
| netCoreProjectFile |
Use the new format (.NET Core) for .NET project files (.csproj). |
|
false |
| nonPublicApi |
Generates code with reduced access modifiers; allows embedding elsewhere without exposing non-public API calls to consumers. |
|
false |
| nullableReferenceTypes |
Use nullable annotations in the project. Only supported on C# 8 / ASP.NET Core 3.1 or newer. Starting in .NET 6.0 the default is true. |
|
false |
| operationParameterSorting |
One of legacy, alphabetical, default. |
|
default |
| optionalAssemblyInfo |
Generate AssemblyInfo.cs. |
|
true |
| optionalEmitDefaultValues |
Set DataMember's EmitDefaultValue. |
|
false |
| optionalMethodArgument |
C# Optional method argument, e.g. void square(int x=10) (.net 4.0+ only). |
|
true |
| optionalProjectFile |
Generate {PackageName}.csproj. |
|
true |
| packageGuid |
The GUID that will be associated with the C# project |
|
null |
| packageName |
C# package name (convention: Title.Case). |
|
Org.OpenAPITools |
| packageTags |
Tags to identify the package |
|
null |
| packageVersion |
C# package version. |
|
1.0.0 |
| releaseNote |
Release note, default to 'Minor update'. |
|
Minor update |
| returnICollection |
Return ICollection<T> instead of the concrete type. |
|
false |
| sourceFolder |
source folder for generated code |
|
src |
| targetFramework |
The target .NET framework version. To target multiple frameworks, use ; as the separator, e.g. netstandard2.1;netcoreapp3.1 |
- netstandard1.3
- .NET Standard 1.3
- netstandard1.4
- .NET Standard 1.4
- netstandard1.5
- .NET Standard 1.5
- netstandard1.6
- .NET Standard 1.6
- netstandard2.0
- .NET Standard 2.0
- netstandard2.1
- .NET Standard 2.1
- net47
- .NET Framework 4.7
- net48
- .NET Framework 4.8
- net8.0
- .NET 8.0 (End of Support 10 November 2026)
- net9.0
- .NET 9.0 (End of Support 12 May 2026)
|
net9.0 |
| useCollection |
Deserialize array types to Collection<T> instead of List<T>. |
|
false |
| useDateTimeForDate |
Use DateTime to model date properties even if DateOnly supported. (.net 6.0+ only) |
|
false |
| useDateTimeOffset |
Use DateTimeOffset to model date-time properties |
|
false |
| useIntForTimeout |
Use int for Timeout (fall back to v7.9.0 templates). This option (for restsharp only) will be deprecated so please migrated to TimeSpan instead. |
|
false |
| useOneOfDiscriminatorLookup |
Use the discriminator's mapping in oneOf to speed up the model lookup. IMPORTANT: Validation (e.g. one and only one match in oneOf's schemas) will be skipped. |
|
false |
| useSourceGeneration |
Use source generation where available (only generichost library supports this option). |
|
false |
| useVirtualForHooks |
Generate code that exposes public virtual hooks on ApiClient to customize low-level HTTP requests (only restsharp. httpclient libraries support this option). |
|
false |
| validatable |
Generates self-validatable models. |
|
true |
| zeroBasedEnums |
Enumerations with string values will start from 0 when true, 1 when false. If not set, enumerations with string values will start from 0 if the first value is 'unknown', case insensitive. |
|
null |