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

Mysterious error in custom connector appearing after several months and no changes

I went to go in an add another action to a custom connector I have. This would the 11th one. I've been using it for months with no issue. No I get this error when I click "Update connector"... this is with and without the new action. It just happens going into the Definition and not changing anything at all:

Specified swagger has the following errors: 'Definition is not valid. Error: 'Critical : paths/~1workspaces/post/parameters/0/schema/properties/workspace/properties/title/x-ms-visibility : The type of the property is incorrect. Expected type 'String', but value is of type 'Null'.

Like most MS error messages, it tells me nothing. Doesn't indicate which Action could be causing this or how to go about resolving it. To reiterate, again, nothing has changed in this connector in months. This just started to appear whether I try to add a new action, or not, just clicking "Update connector"

Most Valuable Professional
Most Valuable Professional

Hi @ishraqiyun77 


Are you getting the result as JSON? So in your schema related error field is expecting type as string.


"type": "string"


Looks like you getting null


Change the related field schema as follows:


"type": ["string", "null"]


Did I answer your question? Mark my post as a solution!

If you liked my response, please consider giving it a thumbs up

Proud to be a Flownaut!

Learn more from my blog
Power Automate Video Tutorials

Hi, not sure I'm following 100%.

Where do I make this edit? Why is this error coming up all of sudden after months of no issues?

There is nothing anywhere in the interface indicating where this error is.

I looked at the swagger editor, which Power Automate generates not me, and there are two errors:Screenshot from 2020-03-23 12-04-37.png

I resolve the issues by removing the actions associated with the errors. They aren't used anyway.

I then click "Update Connector" and get the same error. Refresh the page and the actions are back that I removed.

This error isn't preventing me from saving or doing anything and there is no explanation as to why it is here after months of no issues.

Frequent Visitor

I am also getting this error now when trying to edit an existing custom connector that has already been deployed.


So simply editing the description of a previously successfully deployed customer connector and clicking "Update Connector" now results in the following error at the top of the page



Specified swagger has the following errors: 'Definition is not valid. Error: 'Error : paths/~1convertWordDocumentFunction/post/parameters/0/schema/properties/document : A schema with type/format 'string/binary' can only be at the top level of a body or formData parameter. ## Error : paths/~1mergeWordDocumentsFunction/post/parameters/0/schema/properties/sourcedocument : A schema with type/format 'string/binary' can only be at the top level of a body or formData parameter. ## Error : paths/~1mergeWordDocumentsFunction/post/parameters/0/schema/properties/destinationdocument : A schema with type/format 'string/binary' can only be at the top level of a body or formData parameter. ## Error : paths/~1convertExcelDocumentFunction/post/parameters/0/schema/properties/document : A schema with type/format 'string/binary' can only be at the top level of a body or formData parameter. ## Error : paths/~1renderExcelChartFunction/post/parameters/0/schema/properties/document : A schema with type/format 'string/binary' can only be at the top level of a body or formData parameter. ## Error : paths/~1convertPresentationDocumentFunction/post/parameters/0/schema/properties/document : A schema with type/format 'string/binary' can only be at the top level of a body or formData parameter. ## Error : paths/~1formatPresentationFunction/post/parameters/0/schema/properties/document : A schema with type/format 'string/binary' can only be at the top level of a body or formData parameter. ## Error : paths/~1mergePresentationDocumentsFunction/post/parameters/0/schema/properties/sourcedocument : A schema with type/format 'string/binary' can only be at the top level of a body or formData parameter. ## Error : paths/~1mergePresentationDocumentsFunction/post/parameters/0/schema/properties/destinationdocument : A schema with type/format 'string/binary' can only be at the top level of a body or formData parameter. ## Error : paths/~1convertPdfDocumentFunction/post/parameters/0/schema/properties/document : A schema with type/format 'string/binary' can only be at the top level of a body or formData parameter. ## Error : paths/~1convertVisioDocumentFunction/post/parameters/0/schema/properties/document : A schema with type/format 'string/binary' can only be at the top level of a body or formData parameter. ## Error : paths/~1convertOnenoteDocumentFunction/post/parameters/0/schema/properties/document : A schema with type/format 'string/binary' can only be at the top level of a body or formData parameter. ## Error : paths/~1convertHtmlFunction/post/parameters/0/schema/properties/outputformatoptions/x-ms-dynamic-schema/parameters/OutputFormat/parameter : The dynamic schema extension references properties within parameters. You need to define the 'x-ms-dynamic-properties' extension. ## Error : paths/~1convertWordDocumentFunction/post/parameters/0/schema/properties/outputformatoptions/x-ms-dynamic-schema/parameters/OutputFormat/parameter : The dynamic schema extension references properties within parameters. You need to define the 'x-ms-dynamic-properties' extension. ## Error : paths/~1convertExcelDocumentFunction/post/parameters/0/schema/properties/outputformatoptions/x-ms-dynamic-schema/parameters/OutputFormat/parameter : The dynamic schema extension references properties within parameters. You need to define the 'x-ms-dynamic-properties' extension. ## Error : paths/~1convertPresentationDocumentFunction/post/parameters/0/schema/properties/outputformatoptions/x-ms-dynamic-schema/parameters/OutputFormat/parameter : The dynamic schema extension references properties within parameters. You need to define the 'x-ms-dynamic-properties' extension. ## Error : paths/~1convertPdfDocumentFunction/post/parameters/0/schema/properties/outputformatoptions/x-ms-dynamic-schema/parameters/OutputFormat/parameter : The dynamic schema extension references properties within parameters. You need to define the 'x-ms-dynamic-properties' extension. ## Error : paths/~1convertVisioDocumentFunction/post/parameters/0/schema/properties/outputformatoptions/x-ms-dynamic-schema/parameters/OutputFormat/parameter : The dynamic schema extension references properties within parameters. You need to define the 'x-ms-dynamic-properties' extension. ## Error : paths/~1convertOnenoteDocumentFunction/post/parameters/0/schema/properties/outputformatoptions/x-ms-dynamic-schema/parameters/OutputFormat/parameter : The dynamic schema extension references properties within parameters. You need to define the 'x-ms-dynamic-properties' extension. '


So it looks like MS has changed the validation and broke the ability to edit and deploy the schema. 
Can someone from MS tell us what we are not mean't to do as this is valid Swagger 2.0 according to the editor and I can't find any blogs or documentation (which is poor for custom connectors) about any changes

They basically told me:

This looks like a bug with the Swagger Editor itself, which is not owned by Microsoft.


The customer will need to work directly with Smartbear, who support Swagger.  We don’t support swagger design.  Smartbear would need to continue to assist them with Swagger. The Power Platforms products from Microsoft simply render the Swagger Editor from on the page.  Their Swagger code will display the same errors directly on the editor at


That answer is non-sense from Microsoft.


So the current situation is:

1. Go the the Power Apps portal

2. Go to custom connectors

3. Select Edit

4. Click Update Connector. No changes are made and I don't switch the Swagger editor on either.

5. Receive all those definitions errors. No validation issues are shown in the front-end prior to this


So if you don't switch to the Swagger editor, how would you expect people to resolve these issues, or where is the migration path now you have broke peoples connectors by changing the validation applied to them.


This is really poor version handling

Advocate I
Advocate I

Getting similar error

Specified swagger has the following errors: 'Definition is not valid. Error: 'Critical : paths/~............/parameters/0/schema/properties/summary/x-ms-visibility : The type of the property is incorrect. Expected type 'String', but value is of type 'Null'.

Same situation, connector is in use and works, has been for months, now I need to add a new API call. I can't anymore.

I had some errors in the swagger editor, fixed those, but still getting this error at the top of the connector edit screen.


This whole custom connector stuff is so unreliable. Every time I have something to update in there or add, it ends up taking most of my day. I love the feature, cleans up a lot of my flows, but man it's so inconsistent.

I had a similar issue:  "Specified swagger has the following errors: 'Definition is not valid. Error: 'Error : paths/.../schema/properties/Id/default : The 'default' value is of type 'Integer', but should match the given type 'String'."


In my case, the API was a POST request.  The body of the message has an Id field.  I had to edit the Definition -> Request -> body -> Id and change the default value from a number to blank.  Swagger must be trying to interpret the default string value to a number, is successful, and then fails because the Id parameter should be a string.  A numeric string is still a string.  I didn't require the default value to be there as it will be filled in by the Power Automate flow anyway but it was annoying to start getting this error.


I know this isn't quite what others are seeing but perhaps it will point people in the right direction.

Thanks for this message. Had exactly same issue as you...when changing ID number from 1 to "blank" error message disappeared . Appreciate sharing your issue. I do think it is weird that it is listed in official Microsoft tutorial like this and then does not support or changes the tutorial. 

Power Automate
Power Automate


Thanks for reporting!

This is an old thread. We have addressed some of the issues discussed here. Can you repost on a new thread with the issue you are facing? I am sure there are many improvements we can do.



Helpful resources


Celebrating the June Super User of the Month: Markus Franz

Markus Franz is a phenomenal contributor to the Power Apps Community. Super Users like Markus inspire others through their example, encouragement, and active participation.    The Why: "I do this to help others achieve what they are trying to do. As a total beginner back then without IT background I know how overwhelming things can be, so I decided to jump in and help others. I also do this to keep progressing and learning myself." Thank you, Markus Franz, for your outstanding work! Keep inspiring others and making a difference in the community! 🎉  Keep up the fantastic work! 👏👏 Markus Franz | LinkedIn  Power Apps: mmbr1606  

Copilot Cookbook Challenge | Week 1 Results | Win Tickets to the Power Platform Conference

We are excited to announce the "The Copilot Cookbook Community Challenge is a great way to showcase your creativity and connect with others. Plus, you could win tickets to the Power Platform Community Conference in Las Vegas in September 2024 as an amazing bonus.   Two ways to enter: 1. Copilot Studio Cookbook Gallery: 2. Power Apps Copilot Cookbook Gallery:   There will be 5 chances to qualify for the final drawing: Early Bird Entries: March 1 - June 2Week 1: June 3 - June 9Week 2: June 10 - June 16Week 3: June 17 - June 23Week 4: June 24 - June 30     At the end of each week, we will draw 5 random names from every user who has posted a qualifying Copilot Studio template, sample or demo in the Copilot Studio Cookbook or a qualifying Power Apps Copilot sample or demo in the Power Apps Copilot Cookbook. Users who are not drawn in a given week will be added to the pool for the next week. Users can qualify more than once, but no more than once per week. Four winners will be drawn at random from the total qualifying entrants. If a winner declines, we will draw again at random for the next winner.  A user will only be able to win once. If they are drawn multiple times, another user will be drawn at random. Prizes:  One Pass to the Power Platform Conference in Las Vegas, Sep. 18-20, 2024 ($1800 value, does not include travel, lodging, or any other expenses) Winners are also eligible to do a 10-minute presentation of their demo or solution in a community solutions showcase at the event. To qualify for the drawing, templates, samples or demos must be related to Copilot Studio or a Copilot feature of Power Apps, Power Automate, or Power Pages, and must demonstrate or solve a complete unique and useful business or technical problem. Power Automate and Power Pagers posts should be added to the Power Apps Cookbook. Final determination of qualifying entries is at the sole discretion of Microsoft. Weekly updates and the Final random winners will be posted in the News & Announcements section in the communities on July 29th, 2024. Did you submit entries early?  Early Bird Entries March 1 - June 2:  If you posted something in the "early bird" time frame complete this form: if you would like to be entered in the challenge.   Week 1 Results:  Congratulations to the Week 1 qualifiers, you are being entered in the random drawing that will take place at the end of the challenge. Copilot Cookbook Gallery:Power Apps Cookbook Gallery:1.  @Mathieu_Paris 1.   @SpongYe 2.  @Dhanush 2.   @Deenuji 3.  n/a3.   @Nived_Nambiar  4.  n/a4.   @ManishSolanki 5.  n/a5.    n/a

Your Moment to Shine: 2024 PPCC’s Got Power Awards Show

For the third year, we invite you, our talented community members, to participate in the grand 2024 Power Platform Community Conference's Got Power Awards. This event is your opportunity to showcase solutions that make a significant business impact, highlight extensive use of Power Platform products, demonstrate good governance, or tell an inspirational story. Share your success stories, inspire your peers, and show off some hidden talents.  This is your time to shine and bring your creations into the spotlight!  Make your mark, inspire others and leave a lasting impression. Sign up today for a chance to showcase your solution and win the coveted 2024 PPCC’s Got Power Award. This year we have three categories for you to participate in: Technical Solution Demo, Storytelling, and Hidden Talent.      The Technical solution demo category showcases your applications, automated workflows, copilot agentic experiences, web pages, AI capabilities, dashboards, and/or more. We want to see your most impactful Power Platform solutions!  The Storytelling category is where you can share your inspiring story, and the Hidden Talent category is where your talents (such as singing, dancing, jump roping, etc.) can shine! Submission Details:  Fill out the submission form by July 12th with details and a 2–5-minute video showcasing your Solution impact. (Please let us know you're coming to PPCC, too!)After review by a panel of Microsoft judges, the top storytellers will be invited to present a virtual demo presentation to the judges during early August. You’ll be notified soon after if you have been selected as a finalist to share your story live at PPCC’s Got Power!  The live show will feature the solution demos and storytelling talents of the top contestants, winner announcements, and the opportunity to network with your community.  It's not just a showcase for technical talent and storytelling showmanship, show it's a golden opportunity to make connections and celebrate our Community together! Let's make this a memorable event! See you there!   Mark your calendars! Date and Time: Thursday, Sept 19th Location: PPCC24 at the MGM Grand, Las Vegas, NV 

Tuesday Tip | Accepting Solutions

It's time for another TUESDAY TIPS, your weekly connection with the most insightful tips and tricks that empower both newcomers and veterans in the Power Platform Community! Every Tuesday, we bring you a curated selection of the finest advice, distilled from the resources and tools in the Community. Whether you’re a seasoned member or just getting started, Tuesday Tips are the perfect compass guiding you across the dynamic landscape of the Power Platform Community.   To enhance our collaborative environment, it's important to acknowledge when your question has been answered satisfactorily. Here's a quick guide on how to accept a solution to your questions: Find the Helpful Reply: Navigate to the reply that has effectively answered your question.Accept as Solution: Look for the "Accept as Solution" button or link, usually located at the bottom of the reply.Confirm Your Selection: Clicking this button may prompt you for confirmation. Go ahead and confirm that this is indeed the solution.Acknowledgment: Once accepted, the reply will be highlighted, and the original post will be marked as "Solved". This helps other community members find the same solution quickly. By marking a reply as an accepted solution, you not only thank the person who helped you but also make it easier for others with similar questions to find answers. Let's continue to support each other by recognizing helpful contributions. 

Reminder: To register for the Community Ambassador Call on June 13th

Calling all Super Users & User Group Leaders   Reminder: To register for the Community Ambassador Call on June 13th—for an exclusive event for User Group Leaders and Super Users! This month is packed with exciting updates and activities within our community.   What's Happening: Community Updates: We'll share the latest developments and what's new in our vibrant community.Special Guest Speaker: Get ready for an insightful talk and live demo of Microsoft Copilot Studio templates by our special guest.Regular Updates: Stay informed with our routine updates for User Groups and Super Users.Community Insights: We'll provide general information about ongoing and upcoming community initiatives. Don't Miss Out: Register Now: Choose the session that fits your schedule best.Check your private messages or Super User Forum for registration links. We're excited to connect with you and continue building a stronger community together.   See you at the call!  

May 2024 Community Newsletter

It's time for the May Community Newsletter, where we highlight the latest news, product releases, upcoming events, and the amazing work of our outstanding Community members.   If you're new to the Community, please make sure to follow the latest News & Announcements and check out the Community on LinkedIn as well! It's the best way to stay up-to-date with all the news from across Microsoft Power Platform and beyond.        COMMUNITY HIGHLIGHTS Check out the most active community members of the last month! These hardworking members are posting regularly, answering questions, kudos, and providing top solutions in their communities. We are so thankful for each of you--keep up the great work! If you hope to see your name here next month, follow these awesome community members to see what they do!   Power AppsPower AutomateCopilot StudioPower PagesWarrenBelzcreativeopinionExpiscornovusFubarAmikNived_NambiarPstork1OliverRodriguesmmbr1606ManishSolankiMattJimisonragavanrajantimlSudeepGhatakNZrenatoromaoLucas001iAm_ManCatAlexEncodianfernandosilvaOOlashynJmanriqueriosChriddle  BCBuizerExpiscornovus  a33ikBCBuizer  SebSDavid_MA  dpoggermannPstork1     LATEST NEWS   We saw a whole host of amazing announcements at this year's #MSBuild, so we thought we'd share with you a bite sized breakdown of the big news via blogs from Charles Lamanna, Sangya Singh, Ryan Cunningham, Kim Manis, Nirav Shah, Omar Aftab, and ✊🏾Justin Graham :   New ways of development with copilots and Microsoft Power PlatformRevolutionize the way you work with Automation and AIPower Apps is making it easier for developers to build with Microsoft Copilot and each otherCopilot in Microsoft Fabric is now generally available in Power BIUnlock new levels of productivity with Microsoft Dataverse and Microsoft Copilot StudioMicrosoft Copilot Studio: Building copilots with agent capabilitiesMicrosoft Power Pages is bringing the new standard in secure, AI-powered capabilities   If you'd like to relive some of the highlights from Microsoft Build 2024, click the image below to watch a great selection of on-demand Keynotes and sessions!         WorkLab Podcast with Charles Lamanna   Check out the latest episode of the WorkLab podcast with CVP of Business Apps and Platforms at Microsoft, Charles Lamanna, as he explains the ever-expanding evolution of Copilot, and how AI is offering new opportunities for business leaders. Grab yourself a coffee and click the image below to take a listen.       Event Recap: European Collaboration and Cloud Summits 2024   Click the image below to read a great recap by Mark Kashman about the recent European Collaboration Summit and European Cloud Summit held in Germany during May 2024. Great work everybody!       UPCOMING EVENTS European Power Platform Conference - SOLD OUT! Congrats to everyone who managed to grab a ticket for the now SOLD OUT European Power Platform Conference, which takes place in beautiful Brussels, Belgium, on 11-13th June. With a great keynote planned from Ryan Cunningham and Sangya Singh, plus expert sessions from the likes of Aaron Rendell, Amira Beldjilali, Andrew Bibby, Angeliki Patsiavou, Ben den Blanken, Cathrine Bruvold, Charles Sexton, Chloé Moreau, Chris Huntingford, Claire Edgson, Damien Bird, Emma-Claire Shaw, Gilles Pommier, Guro Faller, Henry Jammes, Hugo Bernier, Ilya Fainberg, Karen Maes, Lindsay Shelton, Mats Necker, Negar Shahbaz, Nick Doelman, Paulien Buskens, Sara Lagerquist, Tricia Sinclair, Ulrikke Akerbæk, and many more, it looks like the E in #EPPC24 stands for Epic!   Click the image below for a full run down of the exciting sessions planned, and remember, you'll need to move quickly for tickets to next year's event!       AI Community Conference - New York - Friday 21st June Check out the AI Community Conference, which takes place at the Microsoft Corporate building on Friday 21st June at 11 Times Square in New York City. Here, you'll have the opportunity to explore the latest trends and breakthroughs in AI technology alongside fellow enthusiasts and experts, with speakers on the day including Arik Kalininsky, Sherry Xu, Xinran Ma, Jared Matfess, Mihail Mateev, Andrei Khaidarov, Ruven Gotz, Nick Brattoli, Amit Vasu, and more. So, whether you're a seasoned professional or just beginning your journey into AI, click the image below to find out more about this exciting NYC event.       TechCon365 & Power Platform Conference - D.C. - August 12-16th ** EARLY BIRD TICKETS END MAY 31ST! ** Today's the perfect time to grab those early bird tickets for the D.C. TechCon365 & PWRCON Conference at the Walter E Washington Center on August 12-16th! Featuring the likes of Tamara Bredemus, Sunny Eltepu, Lindsay Shelton, Brian Alderman, Daniel Glenn, Julie Turner, Jim Novak, Laura Rogers, Microsoft MVP, John White, Jason Himmelstein, Luc Labelle, Emily Mancini, MVP, UXMC, Fabian Williams, Emma Wiehe, Amarender Peddamalku, and many more, this is the perfect event for those that want to gain invaluable insights from industry experts. Click the image below to grab your tickets today!         Power Platform Community Conference - Sept. 18-20th 2024 Check out some of the sessions already planned for the Power Platform Community Conference in Las Vegas this September. Holding all the aces we have Kristine Kolodziejski, Lisa Crosbie, Daniel Christian, Dian Taylor, Scott Durow🌈, David Yack, Michael O. and Aiden Kaskela, who will be joining the #MicrosoftCommunity for a series of high-stakes sessions! Click the image below to find out more as we go ALL-IN at #PPCC24!       For more events, click the image below to visit the Community Days website.    

Top Solution Authors
Users online (4,941)