Skip to main content
Solved

Error when Importing API Swagger

  • February 14, 2025
  • 3 replies
  • 78 views

Stijn Verhoeff
Starter

We are using the new 'Import Swagger/OpenAPI’ feature in the TX REST Data Source (absolutely loving that btw), but are encountering an error. 

 

When importing the URL for a Weather API, we receive the following error message:

Error: Exception Type: Microsoft.OpenApi.Readers.Exceptions.OpenApiUnsupportedSpecVersionException Message: OpenAPI specification version '3.1.0' is not supported.

 

So far we've had no trouble importing Open API spec 3.0.0 documentation. Is there a compatibility issue with the latest 3.1.0 spec?

Best answer by Thomas Lind

Hi ​@Stijn Verhoeff 

I got a response.

We use OpenAPI.net to read and parse the swagger. The current version does not support version 3.1.0, but there is a preview version that supports it. 
https://github.com/microsoft/OpenAPI.NET/issues/795
They are currently on preview 7. 

 

They will work on this for a future release. The decision to be made is whether to wait for a full release instead of getting it to work with the preview release.

For now there doesn’t seem like a workaround for this, I could not find a way to make it use version 3.0.0.

View original
Did this topic help you find an answer to your question?

3 replies

Thomas Lind
Community Manager
Forum|alt.badge.img+5
  • Community Manager
  • 1017 replies
  • February 17, 2025

Hi ​@Stijn Verhoeff 

I will try to figure this out.


Thomas Lind
Community Manager
Forum|alt.badge.img+5
  • Community Manager
  • 1017 replies
  • Answer
  • February 17, 2025

Hi ​@Stijn Verhoeff 

I got a response.

We use OpenAPI.net to read and parse the swagger. The current version does not support version 3.1.0, but there is a preview version that supports it. 
https://github.com/microsoft/OpenAPI.NET/issues/795
They are currently on preview 7. 

 

They will work on this for a future release. The decision to be made is whether to wait for a full release instead of getting it to work with the preview release.

For now there doesn’t seem like a workaround for this, I could not find a way to make it use version 3.0.0.


Stijn Verhoeff
Starter

Hi ​@Thomas Lind

Thanks for the quick response! That in itself is already an answer; we'll pursue other sources first while awaiting this release. Seeing as there is already a preview 8 by now, there does seem to be active development from their side. Do what you think is wise; we’re eager to use it whenever it becomes available! 

It might be useful for others to list this as a compatibility issue on the REST Data Source's documentation page. With how valuable this feature has been already, I expect others will soon run into the same issue. 


Cookie policy

We use cookies to enhance and personalize your experience. If you accept you agree to our full cookie policy. Learn more about our cookies.

 
Cookie settings