Update OpenAPI specification to version 3.1 once supported by Swagger UI

Once Swagger UI supports version 3.1 of the OpenAPI specification, we should update our specification document as discussed in !151 (comment 11854) to make use of prefixItems.