File Upload via Multipart Requests

1 File uploads with other data
2 Multiple File Upload

File uploads with other data

First, use the requestBody keyword to describe the request payload containing a file. Under content, you can use the multipart media type to describe a file sent with other data.

The following example shows how to upload a file via multipart request in OAS3. If you are using an OAS2 API definition, please refer to this swagger document on multipart form file uploads.

requestBody:
        content:
          multipart/form-data:
            schema:
              type: object
              properties:
                orderId:
                  type: integer
                userId:
                  type: integer
                fileName:
                  type: string
                  format: binary

Multiple File Upload

You can use the multipart media type to define uploading an array of files.

requestBody:
        content:
          multipart/form-data:
            schema:
              type: object
              properties:
                filename:
                  type: array
                  items:
                    type: string
                    format: binary