A modern programming language that makes developers happier.

kotlinlang

Hey channel! :wave:

We now have a prototype of the **OpenAPI spec generation support** available for testing!

It allows for automatic OpenAPI spec generation for your routes during compilation. This will make it easier to document your APIs, generate client libraries, and collaborate with other developers.

If you're interested in trying it out:

1. Check out the <https://github.com/bjhham/open-api-eap-template|template project>.  This demonstrates how to configure your Gradle with the correct EAP builds and the new DSL.
2. Refer to the <https://github.com/ktorio/ktor-klip/pull/3|KLIP design doc>.  Feel free to comment!
3. Fill out this <https://surveys.jetbrains.com/s3/Ktor-OpenAPI-Feature-Feedback|short survey>.  This will help us to move in the right direction.
Thanks for your support!

Awesome..by the way the template project is missing the wrapper jar
```$ ./gradlew build
Error: Unable to access jarfile ../open-api-eap-template/gradle/wrapper/gradle-wrapper.jar```

Also, `/docs` is not showing any openapi docs ..is that expected ?
```2025-08-14 15:11:28.442 [main] INFO  Application - Application started in 0.416 seconds.
2025-08-14 15:11:28.443 [DefaultDispatcher-worker-1] ERROR i.s.c.v.g.html.StaticHtml2Codegen - Swagger object description is empty [null]
2025-08-14 15:11:28.443 [DefaultDispatcher-worker-1] ERROR i.s.codegen.v3.DefaultGenerator - Missing required field info version. Default appVersion set to 1.0.0
2025-08-14 15:11:28.443 [DefaultDispatcher-worker-1] ERROR i.s.codegen.v3.DefaultGenerator - Missing required field info version. Default version set to 1.0.0
2025-08-14 15:11:28.556 [DefaultDispatcher-worker-2] INFO  Application - Responding at <http://0.0.0.0:8080>
2025-08-14 15:11:28.565 [DefaultDispatcher-worker-1] INFO  i.s.codegen.v3.AbstractGenerator - writing file docs/index.html
2025-08-14 15:11:28.769 [DefaultDispatcher-worker-1] INFO  i.s.codegen.v3.AbstractGenerator - writing file docs/.swagger-codegen/VERSION```

Screenshot 2025-08-14 at 23.16.13.png

Thanks for trying, I've added the missing wrapper jar.  It looks like the spec file didn't generate... you should see the files under the build dir like this:

we don't have any good debugging for the file generation yet, so there won't be anything useful in the build log unfortunately