We ended up using this gem to implement OpenAPI: https://github.com/a-chacon/oas_rails, it was quite straightforward