openapi.yaml

openapi: '3.0.0'
info:
  title: "Foo"
  version: 1.0.0
  
servers:
  - url: https://foo/v1/api
    
paths:
  /upload/:
    post:
      tags:
      - "upload"
      operationId: "upload"

      requestBody:
        required: true
        content: 
          multipart/form-data: # Media type
            schema:
              type: object
              properties: # Request parts
                file:
                  type: string
                  format: binary
                options:
                  type: object
                  properties:
                    some_array:
                      type: array
                      items:
                        type: string
                    max_bar:
                      type: integer
                      default: 300
            encoding:
              options:
                contentType: application/json
                    
      responses:
        '200':
          description: ok
          content:
            application/json:
              schema:
                type: object
                properties: 
                  foo:
                    type: string