Include array responses in http_codes?

Hi everyone,

I found the is_array in the desc parameter for an API endpoint to specify an array as response. But I didn't find how to specify that in the http_codes part, something like:

          desc "List All Delivery",
            is_array: true,
            entity: ::Delivery::Entity,
            http_codes: [
              [200, 'OK', ::Delivery::Entity],
              [401, 'Unauthorized', API::Entities::Error],
              [403, 'Forbidden', API::Entities::Error]
          ]
          get do
            present(paginate(::Delivery.all),
                    with: ::Delivery::Entity)
          end

The generated Swagger documentation is my code makes you think the 200 response will give you a Hash but it won't, it's an array. Is there a way to do that?

Thanks.

Start from the desc declaration and its is_array and http_codes options shown in the issue, then trace how the generated Swagger/OpenAPI response schema is formed. Done means the 200 response is documented as an array while the 401 and 403 responses remain error entities; the issue names no file or test path.