Unable to edit the openAPI specification for multipart/form-data for documentation

andrie 41 Reputation points
2021-05-28T12:28:38.527+00:00

Hi, I have an API that use the multipart/form-data request, but I can't edit it in openAPI Specification. Is it not supported yet? or Is it possible to create a definition for a sample request, using multipart/form-data?
I need it to give an example request in the developer portal.

This is how I define the request for multipart/form-data

100607-screen-shot-2021-05-29-at-114324.png

And this is what shown if I try to edit it with OpenAPI specification
100637-screen-shot-2021-05-29-at-114345.png

Azure API Management
Azure API Management
An Azure service that provides a hybrid, multi-cloud management platform for APIs.
2,446 questions
0 comments No comments
{count} votes

Accepted answer
  1. MikeUrnun 9,777 Reputation points Moderator
    2021-05-31T21:47:27.737+00:00

    Hello @andrie - Yes, unfortunately, multipart form-data is not supported at this time in the APIM dev portal: https://github.com/Azure/api-management-developer-portal/issues/316

    With that said, it looks like the API operations themselves will work when OpenAPI v3 spec is used to import the definitions: https://stackoverflow.com/questions/63143532/how-to-send-post-form-data-with-file-and-data-using-azure-api-management

    If you opt to self-host your Developer Portal, you can probably customize per your requirement and override this limitation.

    1 person found this answer helpful.
    0 comments No comments

0 additional answers

Sort by: Most helpful

Your answer

Answers can be marked as Accepted Answers by the question author, which helps users to know the answer solved the author's problem.