Lze pomocí OpenAPI popsat odesílání více souborů?

Ano, v OpenAPI lze popsat odesílání více souborů. Obvykle se k tomu používá typ multipart/form-data s polem souborů. V specifikaci OpenAPI 3.0 se to provádí přes parametr typu array s prvky typu string a formátem binary.

Příklad popisu parametru pro více souborů:

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

Tento přístup umožňuje klientovi odeslat více souborů v jednom požadavku.