DOC error : flowable-task REST url

Hi,
1 /
The doc section 7.3.1, gives this url : “form/form-instances” which is wrong.
the url which works is http://localhost:8080/flowable-task/form-api/form/form-instances

curl --user admin:test “http://localhost:8080/flowable-task/form-api/form/form-instances
=>
{“data”:[{“id”:“25”,
“formDefinitionId”:“83f69515-9eaf-11e7-b72d-06e7426c6f5f”,
“taskId”:“18”,
“processInstanceId”:“12”,
“processDefinitionId”:null,
“submittedDate”:1505987357803,
“submittedBy”:null,
“formValuesId”:null,
“tenantId”:"",
“url”:"/query/form-instances"
},{

2 /
second point : according to the doc, if i want to get the value of fields of a form instance, i only need to add the id of this form which is 25 in this case (given by result of first request)
but the url
curl --user admin:test "http://localhost:8080/flowable-task/form-api/form/form-instances/25
gives HTTP 404

3 /
Doc says
7.4.1 Get a form instance
GET form/form-instances/{formInstanceId}
but "http://localhost:8080/flowable-task/form-api/form/form-instances"
gives no field formInstanceId !!

In the doc, section 7.4.1

replace
GET form/form-instances/{formInstanceId}
by
GET form/form-instance/{Id}
(no S at the end of form-instance)

Hello,

Thanks you for your feedback. We will take it into account.

If you encounter other documentation issues in the future please don’t hesitate to create a pull request against https://github.com/flowable/flowable-engine

Documentation files about Flowable Rest API are available here :

Also do you know it’s possible to discover & test Flowable API by installing/using the flowable-rest war file.
To access it simply go to : http://localhost:8080/flowable-rest/docs/
It’s an excellent tool to learn & test the API.

Hope it helps.