SwaggerProvider

Appearance

4.0.0-beta02 - April 18, 2026 ​

  • fix: preserve declared properties when schema has both properties and additionalProperties (#383)
  • refactor: CallAsync returns HttpResponseMessage internally for cleaner response handling (#385)
  • eng: remove stale YamlDotNet dependency (removed with v2 parser in #377) (#386)
  • test: extend OperationCompiler unit tests (+12 tests for asAsync mode, DELETE/PUT, header params) (#380)
  • test: add coverage for cookie params, text/plain response, and default response (+6 tests) (#386)
  • docs: update homepage README for v4.0 (remove SwaggerClientProvider references, update targets) (#379)
  • docs: improve VitePress site — fix badges, flatten nav, dark theme, add features table (#382)
  • ci: bump actions/configure-pages 5→6, deploy-pages 4→5, setup-node 4→6, upload-artifact 7.0.0→7.0.1

4.0.0-beta01 - April 14, 2026 ​

  • BREAKING: remove SwaggerClientProvider and v2 compiler, simplify folder structure (#377)
  • BREAKING: wrap optional scalar reference types in Option<T> (#122) (#357)
  • feat: resolve oneOf/anyOf with single $ref to referenced type (#375)
  • fix: publish portable PDB debug symbols to NuGet package (#361)
  • perf: cache MethodInfo for asyncCast/taskCast to avoid repeated reflection (#374)
  • perf: cache property name/metadata lookups in getPropertyValues (#373)
  • perf: cache reflection lookups and avoid double seq materialisation (#378)
  • docs: improve README with license badge, overview, quick start, and features table (#360)
  • test: add DefinitionPath.Parse unit tests and PreferNullable coverage (#370)
  • test: extend RuntimeHelpers unit-test coverage (#363)
  • eng: add Dependabot for GitHub Actions + v3 OperationCompiler unit tests (#364)
  • ci: bump actions/checkout, actions/cache, actions/setup-dotnet, actions/upload-artifact, actions/github-script, github/gh-aw-actions

3.2.0 - April 6, 2026 ​

  • feat: add CancellationToken support to OpenApiClientProvider generated methods (closes #212) (#336)
  • fix: map format:date to DateOnly on .NET 6+ targets (closes #240) (#321)
  • fix: throw OpenApiException for undocumented HTTP error codes (#354)
  • improve: enrich XML documentation for generated API methods (#349)
  • improve: add allowed enum values to generated property XmlDoc comments (#353)
  • perf: reduce DLL-emit time for large schemas (shared ToString helper + Dictionary lookup) (#356)
  • perf: update FSharp.TypeProviders.SDK (O(n^2) to O(n) ILMethodDefs) (#355)
  • test: add v3 array/map type-mapping tests and v2 schema compilation tests (#351)
  • test: add $ref primitive-type alias tests for v3 DefinitionCompiler (closes #335) (#342)
  • hk: update TP SDK and OpenApi reader

3.1.0 - Mar 22, 2026 ​

  • feat: Add IgnoreParseErrors parameter to OpenApiClientProvider (#300)
  • feat: Add SchemaReaderErrors property to OpenApiClientProvider (fixes #160) (#327)
  • fix: include response body in OpenApiException message (closes #250) (#324)
  • fix: unwrap F# Option<T> in `toParam` for header/path/cookie parameters (closes #140) (#322)
  • fix: 2xx response handling in v2 and v3 OperationCompilers (#313)
  • fix: $0 in path parameter values treated as regex back-reference (#310)
  • fix: Option types in form data not being unwrapped (issue #214) (#298)
  • perf: avoid redundant cache invalidation timers in GetOrAdd (#318)
  • perf: increase type provider cache timeout from 30s to 5 minutes (#329)
  • hk: update FSharp.TypeProviders.SDK (enum custom attribute bug fix) (#330)
  • test: add v3 DefinitionCompiler type-mapping unit tests (#331)
  • test: add UniqueNameGenerator unit tests (#319)
  • test: add unit tests for RuntimeHelpers module (#295)
  • ci: add concurrency group to CI workflow to cancel redundant builds (#309)

3.0.0 - Mar 1, 2026 ​

  • feat: Microsoft.OpenApi v2.x with OpenAPI v3.1 Support
  • feat: Server-Side Request Forgery (SSRF) protection for IP V4 (#271) and V6 (#272)
  • feat: handle text/plain payload types (#276)
  • fix: removed dependency on Microsoft.OpenApi.Readers
  • fix: error messages when operationId is not provided (minimal api) (#277)
  • feat: include TP config information in cache key (#283)
  • feat: add windows-latest ci (#282)
  • feat: Handle allOf with single reference (#284)
  • fix: nullable date deserialization for OpenAPI v3 schemas (#287)
  • docs: the Serialization documentation to mention use of System.Text.Json rather than Newtonsoft.Json (#288)
  • docs: Remove note about TaskBuilder.fs from the OpenApiClientProvider docs (#285)
  • feat: Set the "Accept" request header to the specified type (#290)
  • feat: Specify a Content-Type header on stream type requests when the payload type is known (#292)
  • hk: dependencies update

2.3.2 - Oct 11, 2025 ​

  • Added support for text/* media type (#270) by @spaasis

2.3.1 - May 13, 2025 ​

  • Performance improvement: ProvidedTypes update to the most recent version (#267)

2.3.0 - May 10, 2025 ​

  • Added .NET 8 runtime, updated Microsoft.OpenApi (#265)

2.2.3 - Mar 11, 2025 ​

  • Update ProvidedTypes.fs to latest version of FSharp.TypeProvider.SDK (#262)

2.2.2 - Jan 23, 2025 ​

  • Improvement of design-time error handling (#259)

2.2.1 - Jan 16, 2025 ​

  • Added allOf properties to the schema definition (#256)
  • Update TypeProvider SDK (#257)

2.2.0 - Jan 6, 2025 ​

  • hk: build with .NET 9
  • hk: Dependencies update

2.1.3 - Sep 8, 2024 ​

  • hk: Dependencies update

2.1.2 - Jun 3, 2024 ​

  • fix: Support DateTime/DateTimeOffset as required query parameter, using round-trip format (#244)
  • hk: Dependencies update

2.1.1 - Apr 8, 2024 ​

  • Minor dependency updates

2.1.0 - Mar 14, 2024 ​

  • Build and test with .NET 8.0

2.0.1 - Mar 12, 2024 ​

  • fix: update ProvidedTypes.fs (#235)
  • FSharp.Data utilities update (#238)
  • Updated custom serialization example to SwaggerProvider 2.0 (#239)

2.0.0 - Nov 08, 2023 ​

  • F# 6 task{} instead of async{} under thee hood - #200
  • BREAKING: ProvidedApiClientBase.CallAsync returns task instead of async
  • BREAKING: task CE wrap all exceptions in AggregateException (with OpenApiException inside)
  • Model enums as string, int32 or boolean (Fixed #186 )
  • Add Accept header to all request (Fixed #196)
  • Supported requests with octet-stream body content #203
  • Added missing properties to OpenApiException #222
  • Changed raise to calling Reraise() extension method to preserve the call stack #230
  • Microsoft.OpenApi (1.6.10)
  • FSharp.SystemTextJson (1.2.42)
  • Removed the System.Net.Http dependency (#221)
  • fix: accept "default" as "ok response" fallback (#223)
  • Minor performance tweaks (#233)

1.0.2 - Jul 10, 2022 ​

  • SharpYaml 2.0.0
  • Format code using Fantomas

1.0.1 - Jun 25, 2022 ​

  • Dependencies update

1.0.0 - Apr 17, 2022 ​

  • Target .NET 6
  • Microsoft.OpenApi v1.3.1
  • Migration to System.Text.Json #176
  • Fix for 'FS3033: Payload is not supported' #181
  • Drop net46 support
  • Dependencies update

0.12.1 - Apr 9, 2022 ​

  • Correctly serialize Guid [] as query parameter #192

0.12.0 - Dec 22, 2020 ​

  • OpenApiProvider: Dictionary support #174

0.11.0 - Dec 13, 2020 ​

  • Relative path fix #171
  • DateTime formatted as round-trip #170

0.10.7 - July 15, 2020 ​

  • Avoid NullReferenceException on rare case that response is nothing. #162
  • Dependencies update

0.10.6 - June 8, 2020 ​

  • WebException handling #161

0.10.5 - June 4, 2020 ​

  • Cache, yet one more fix... #158

0.10.4 - May 31, 2020 ​

  • Cache fix part 2 #155

0.10.3 - May 30, 2020 ​

  • Fixed caching #153
  • Dependencies update #154

0.10.2 - April 5, 2020 ​

  • Caching update #144
  • Better autocomplete in IDEs

0.10.1 - April 5, 2020 ​

  • Dependencies update #143

0.10.0 - December 8, 2019 ​

  • OpenApiClientProvider
  • .NET Core 3.1 support

0.10.0-beta13 - December 8, 2019 ​

  • UUID/Guid support #138

0.10.0-beta12 - November 19, 2019 ​

  • Fixed null reference for schemas without Components definitions

0.10.0-beta11 - November 10, 2019 ​

  • Delete method incorrectly cased #120
  • File handling - upload/download files as IO.Stream #131
  • DateTimeOffset as a default date-time type #133
  • Custom OpenApiException instead of HttpRequestException 134

0.10.0-beta10 - November 6, 2019 ​

  • Support REST convention with pluralized entities in mode with IgnoreOperationId=true #121
  • Fixed null refs in optional headers #123

0.10.0-beta09 - November 5, 2019 ​

  • TP parameter names are unified #129

0.10.0-beta08 - November 3, 2019 ​

  • Migration to new Type Provider SDK #88 #125
  • SwaggerParser moved to runtime assembly (and exposed as API to library users) - #90
  • Added runtime dependency on YamlDotNet
  • Removed dependency on FSharp.Data/JsonValue (replaced by JSON.NET)
  • Added full-init constructor for provided types #91
  • Option/Nullable types for not required properties #93
  • Http.fs is moved to SwaggerProvider.Runtime.dll and nicePascalName applied to provided types, because FSI cannot load types with special characters in name (like [ and ]) - fix for #94
  • Provide namespaces as nested types #96
  • Added ability to generate multiple clients (one per controller) This feature is turned off by default and is controlled by IgnoreControllerPrefix parameter #45
  • Supported parsing of schemas with inheritance in types defined inside operation parameters
  • Added Async & Task-based calls for the Operations #21
  • Do not reference design-time assembly when install from nuget #104
  • Migration to HttpClient-based communication #105 #100
  • Fixed null reference in query params #126
  • OpenApiClientProvider #117

0.8.2 - January 19, 2017 ​

  • Fix probing locations #97

0.8.1 - August 21, 2017 ​

  • Removed caching and dependency on FSharp.Configuration context #84

0.8.0 - August 8, 2017 ​

  • Better support for optional parameters #82

0.7.1 - June 1, 2017 ​

  • Newtonsoft.Json v10.0.2

0.7.0 - May 26, 2017 ​

  • Supported Mono 5.0.1.1

0.6.1 - April 15, 2017 ​

  • ToString is overridden for each generated type #52
  • Removed reference from Swagger.Runtime.dll to YamlDotNet.dll

0.6.0 - April 13, 2017 ​

0.5.7 - March 12, 2017 ​

  • Improved URL construction #66

0.5.6 - August 31, 2016 ​

  • Added NTLM auth for schema request #50

0.5.5 - August 20, 2016 ​

  • Allow to configure protocol together with host name #41

0.5.4 - August 19, 2016 ​

  • FIXED: SwaggerProvider and byte array #46

0.5.3 - July 10, 2016 ​

  • Supported Newtonsoft.Json v9.0.1
  • FIXED: props and fields name collision during quotes compilation #38

0.5.2 - June 23, 2016 ​

  • FIXED: 201 status codes should be used as a return type for operations #34

0.5.1 - April 30, 2016 ​

  • FIXED: Collisions in provided type names #27

0.5.0 - April 19, 2016 ​

  • BREAKING CHANGE: Instance methods for provided operations with configurable Host, Headers and modifiable web requests
  • Configurable operation name (IgnoreOperationId parameter)
  • Support of unordered type definitions in schema (for Azure APIs)
  • Allow for custom headers per-request #22
  • Migration to FsUnitTyped + better testing

0.4.0 - April 10, 2016 ​

0.3.6 - April 2 2016 ​

  • Updated JSON.NET version up to v8.0.3
  • Added support of model composition in path's response schema
  • Added support of composite types like ("type": [ "string", "null" ])

0.3.5 - February 25 2016 ​

0.3.4 - January 20 2016 ​

0.3.3 - January 18 2016 ​

  • Fixed code generation for PetStore schema (Removed deprecated attributes from methods)
  • Updated JSON.NET version up to v8.0.2

0.3.2 - December 23 2015 ​

  • Migration to .NET 4.5

0.3.1 - December 23 2015 ​

  • Fixed docs and bug in SwaggerProvider.fsx

0.3.0 - December 22 2015 ​

  • Added support of schemes in YAML format

0.2.0 - December 13 2015 ​

  • AssemblyResolve handler that resolve location of 3rd party dependencies
  • Added dependencies on Newtonsoft.Json NuGet package

0.1.3-beta - December 7 2015 ​

  • Bug fixes

0.1.2-beta - November 22 2015 ​

  • Fixed bug in the query builder for POST and PUT requests
  • Added tests for PUT & DELETE requests

0.1.1-beta - November 19 2015 ​

  • Supported serialization of basic data types for passing in query
  • Fixed bugs in query builder logic
  • Added support of nice names for provided parameters
  • Added support of JSON serialization for properties with nice names
  • Auto Content-Type:application/json header to POST queries when it is supported
  • Fixed bug in float compilation
  • Added communication tests for data transferring to the server

0.1.0-beta - November 17 2015 ​

  • Improved speed: Added caching for generated types
  • Improved support of Swashbuckle generated schemas
  • Fixed bug in compilation to IL
  • Fixed bug in POST calls (Content-Length is set to 0)
  • Fixed bug in definition type names beatification
  • Fixed type coerce bug in provided methods
  • Fixed NuGet package
  • Added Swashbuckle.OWIN.API Server with REST API and communication/deserialization tests

0.0.5-alpha - November 16 2015 ​

  • Added support of object composition

0.0.4-alpha - November 13 2015 ​

  • Added support of Dictionaries
  • Added tests for all samples from Swagger specification

0.0.3-alpha - November 12 2015 ​

  • Implemented new Swagger JSON schema parser
  • Added tests for parsing 200+ real-world Swagger schemas

0.0.2-alpha - November 03 2015 (Delegate) ​

  • Added instantiation of Swagger Definitions
  • Added invocation of Swagger Operations
  • Added global HTTP header option to the Swagger Provider constructor

0.0.1-alpha - April 20 2015 (Sergey Tihon) ​

  • Added Swagger Definition and Operations compilation
  • Initial release