title: open api 3 posting an array of files
body: <p>I am using swagger hub to <a href="https://app.swaggerhub.com/apis/PHP-Point-Of-Sale/PHP-Point-Of-Sale/1.0" rel="nofollow noreferrer">create this API</a>; but it doesn't support multi files in the UI so I am unsure if I am doing this right</p>
  
  <p>My goal is to have the following</p>
  
  <pre><code>item:{Json describe the item}
  images[] = images for item posted as an array
  titles[] = Parallel array to images that has the title for image
  alt_texts[] = Parallel array to images that has the alt text for image
  </code></pre>
  
  <p>This has to be multipart since it is files; but am unsure if I setup the structure correctly.</p>
  
  <p>Swagger/Open API Code</p>
  
  <pre><code>post:
    summary: Add a new item to the store
    description: ''
    operationId: addItem
    requestBody:
      content:
        multipart/form-data:
          schema:
            $ref: '#/components/schemas/NewItemWithImage'
      description: Item object that needs to be added to the store
      required: true
  
  
  NewItemWithImage:
    type: object
    properties:
      item:
        $ref: '#/components/schemas/NewItem'
      images[]:
        type: array
        items:
          type: string
          format: binary
      titles[]:
        type: array
        items:
          type: string
      alt_texts[]:
        type: array
        items:
          type: string
      variation_ids[]:
        type: array
        items:
          type: string
    required:
      - item
  </code></pre>