OpenAPI schema and Response

[Stwissel]

I was reading https://www.the-main-thread.com/p/quarkus-rfc9457-api-error-handling

And wondered what happens to the OpenAPI spec when the return type is Response.

So far I model my endpoints like Uni which works fine for the "happy path".

How would I transit to Response or Uni and also specify potential error data types?

[quarkus-bot[bot]]

/cc @EricWittmann (openapi), @MikeEdgar (openapi), @phillip-kruger (openapi)

[MikeEdgar]

@Stwissel when you're using Response return types, you can use the @APIResponse or @APIResponseSchema annotations on the method. As noted in the linked article, you can also use those annotations for declaring possible errors, and the annotation scanner will also consider exceptions in the throws clause of the method declaration.