How to create documentation for a JSON API using Grails3
This library looks like the most popular choice for Grails 3:
https://github.com/rahulsom/swaggydoc
You can see from the issues that some people have had success getting it to work with 3.x, but as with any open source project your millage may vary.