В Swagger, как определить API, который использует файл вместе с параметром схемы?

Я пытаюсь использовать Swagger для определения API, который принимает фактический файл и объект схемы, который описывает содержимое файла. Вот фрагмент Swagger YAML. Однако это не будет проверяться в редакторе Swagger.

/document:
  post:
    summary: Api Summary
    description: Api Description
    consumes:
      - multipart/form-data
    parameters:
      - name: documentDetails
        in: formData
        description: Document Details
        required: true
        schema:
          $ref: '#/definitions/Document'
      - name: document
        in: formData
        description: The actual document
        required: true
        type: file

Редактор Swagger выдает следующую ошибку проверки:

Ошибка Swagger: данные не соответствуют ни одной схеме из 'oneOf'

Я что-то пропустил? Или это не поддерживаемая функция Swagger?

Ответы на вопрос(3)

Ваш ответ на вопрос