How to properly define multipart/form-data for file upload in Open API 3.0

Ask the Experts and Postman Tips
, ,
1

Hello,

I want to define an upload method in my API using the Open API 3.0 specification. Take a look at this definition:

/upload:
summary: Upload File
post:
requestBody:
description: File Data
content:
multipart/form-data: {}
required: true
responses:
‘200’:
description: File uploaded
summary: Upload File

Notice the {} behind multipart/form-data. If I try to define anything beyond the {} I am unable to validate my API definition in Postman. It doesn’t even give me an error, it just says it cannot validate the API. How do I properly define this so that Postman can validate it?

Thanks,

Kent