# Swagger REST API definitions in flowable 6.3.0 - incompletely generated?

**URL:** <https://forum.flowable.org/t/swagger-rest-api-definitions-in-flowable-6-3-0-incompletely-generated/1896>\
**Category:** Flowable Engine\
**Created:** [April 16, 2018, 6:32pm UTC](https://forum.flowable.org/t/swagger-rest-api-definitions-in-flowable-6-3-0-incompletely-generated/1896 "2018-04-16T18:32:46Z")\
**Posts on this page:** 3\
**Page:** 1

<div class="post-metadata">

**Author:** ![n0n1ck](https://yyz1.discourse-cdn.com/flex035/user_avatar/forum.flowable.org/n0n1ck/32/645_2.png) [@n0n1ck](https://forum.flowable.org/u/n0n1ck)\
**Post date:** [April 16, 2018, 6:32pm UTC](https://forum.flowable.org/t/swagger-rest-api-definitions-in-flowable-6-3-0-incompletely-generated/1896/1 "2018-04-16T18:32:46Z")

</div>

It seems to me in Flowable v6.3.0 with the “flowable-rest.war” the wrong swagger specfiles are distributed/generated in  
“WEB-INF/classes/static/docs/specfile”  
for the “content”, “dmn”, “form” and “idm” API.

For example

> <https://github.com/flowable/flowable-engine/blob/flowable-6.3.0/docs/public-api/references/swagger/form/flowable-swagger-form.yaml>

  
seem correct/complete to me - perhaps a “contract first” approach for the future?

In the build process of “flowable-app-rest” module the swagger-maven-plugin is used to generate a swagger API description for the form API based on  
org.flowable.rest.form.service.api  
which results in a generated swagger definition with no endpoints included, whereas  
org.flowable.rest.service.api  
seems to work and produces a meaningful definition with lots of endpoints/resources.

The corresponding swagger definitions are served from the “flowable-rest” app on  
flowable-rest/docs/specfile/form/flowable.yaml  
and  
flowable-rest/docs/specfile/process/flowable.yaml

I don’t yet understand the “big-picture” from an architectural point of view, so probably I miss out a important detail.

Hope you can enlighten 🙂

Regards, Andreas.

---

<div class="post-metadata">

**Author:** ![Heurazio](https://avatars.discourse-cdn.com/v4/letter/h/67e7ee/32.png) [@Heurazio](https://forum.flowable.org/u/Heurazio)\
**Post date:** [April 20, 2018, 11:08am UTC](https://forum.flowable.org/t/swagger-rest-api-definitions-in-flowable-6-3-0-incompletely-generated/1896/2 "2018-04-20T11:08:32Z")

</div>

Can confirm this problem. Are there any news?

---

<div class="post-metadata">

**Author:** ![filiphr](https://yyz1.discourse-cdn.com/flex035/user_avatar/forum.flowable.org/filiphr/32/315_2.png) [@filiphr](https://forum.flowable.org/u/filiphr)\
**Post date:** [April 20, 2018, 11:24am UTC](https://forum.flowable.org/t/swagger-rest-api-definitions-in-flowable-6-3-0-incompletely-generated/1896/3 "2018-04-20T11:24:47Z")

</div>

It seems that they are missing. This is a mistake on our side. I have created [#1008](https://github.com/flowable/flowable-engine/issues/1008) in order to fix this