Showing results for 
Search instead for 
Did you mean: 
Helper I
Helper I

Custom API registration and 'api-version' parameter

Hi everyone!


I tried to add custom API but I've got an error message:

"The api-version query parameter (?api-version=) is required for all requests" (see the screenshot below).


I can't find any info about this parameter in documentation.

I've browsed many swagger's files on and sample files on

however I haven't got any answer or hint.


Can anyone help me please?





















Power Automate
Power Automate

Hi Victor,


The api-version should correspond to the api version of our APIs: 2016-03-01-preview. Could you try that value ?




Thank you, Andre.

I'am triing to register custom API and I see that your site uses API version '2016-01-01-preview' while making requests.

So required parameter is presented even if its value differ with specified in your message.


Can I force using of specified version API (and where if so)?


See my screenshot please:

Manage - Microsoft Flow – Chromium_006.png

Hi @victor-burre


Could you please share your Swagger ? It seems like you need to add an API version query parameter for your requests. 


Thanks, @Sunay.

Of course, but I don't understand which API version you mean? Mine or yours?


Here is my Swagger file:

Can I expect an answer?

Hi @victor-burre


I went through your Swagger, it uses an OAuth identity provider that we don't support yet. You can check in the documentation here: to see which ones are supported. 


Is there a specific scenario you are trying to enable ? You can check this tutorial where "technically" you can create any service that is authenticated using AAD and proxies calls to any API of your choosing.


(Apologies for the delay in response) 




Why all my new replies are not saved here?

@Sunay, I send private message to you several days ago. Can you give me an answer?

Hey @victor-burre I already responded to your earlier question and I haven't received any other follow up queries. 

Could you please try re-posting your question here ? 




It's also possible that the api-version error was an issue in our Portal. I'd recommend retrying (we've updated a few times since then) in the Flow Portal. If that is still giving you an issue, it's worth trying to create the custom api from the PowerApps portal instead. You'll see the option in their portal if you try to add a connection, then there will be a tab for custom apis.

Helpful resources

Power Platform Conf 2022 768x460.jpg

Join us for Microsoft Power Platform Conference

The first Microsoft-sponsored Power Platform Conference is coming in September. 100+ speakers, 150+ sessions, and what's new and next for Power Platform.

May UG Leader Call Carousel 768x460.png

June User Group Leader Call

Join us on June 28 for our monthly User Group leader call!

MPA Virtual Workshop Carousel 768x460.png

Register for a Free Workshop

Learn to digitize and optimize business processes and connect all your applications to share data in real time.

Power Automate Designer Feedback_carousel.jpg

Help make Flow Design easier

Are you new to designing flows? What is your biggest struggle with Power Automate Designer? Help us make it more user friendly!

Users online (1,102)