Http4k, a http library for Kotlin, has an, in my opinion, great way of generating documentation for you [0]. They explain it in more detail in their talk [1] and also have an example repository [2], if you favor to look at code.

[0] https://www.http4k.org/blog/http4k_v5/#tracerbullet_a_brand_...

[1] https://www.youtube.com/watch?v=CrslqbMbaD8

[2] https://github.com/http4k/exploring-the-testing-hyperpyramid