Are camunda REST resources documented in swagger or open api?

Hello,

Is there a way to have an overview of all the available REST resources in a web page, like using swagger-ui or open api? This would be very useful, thank you

Best regards,
Im

We’ve started describing all of our REST Calls in the OpenAPI standard. We don’t have them complete yet, but it’s only a matter of time.
Check out these docs for more details.

1 Like

One small additional question: how can I use the generator? and under which endpoint the open api doc is available? Thank you (Note: This was not specified in the doc)

Are you looking for the JSON file that describes the OpenAPI?
The full jar can be found here:
https://app.camunda.com/nexus/repository/camunda-bpm/org/camunda/bpm/camunda-engine-rest-openapi/7.13.0/camunda-engine-rest-openapi-7.13.0.jar

And the single file can be found here: start.camunda.com/openapi.json

1 Like

I was looking for a REST endpoint like the following:

http://localhost:8080/engine-rest/v3/api-docs/

Where I can visualize and call the REST apis.

Hi @mk08,

So far such option doesn’t exist.
We have a couple of tickets open for that but we haven’t (Edit) started with the implementation so far:

An alternative till then might be https://editor.swagger.io/, download the documentation from the link that Niall provided and load it in the editor.

Best,
Yana

2 Likes

@Yana: Is there a way to vote on the above tickets? I would also like to see swagger-ui (or some other similar alternative) available as part of the rest engine.

I figured out how to register for the above Jira instance and have voted for the tickets. Please let me know if there is another way to :+1: feature requests such as these.

Thanks!

Hi @nmische,

Thank you for you interest.
Another option to move the ticket further is community contribution. Please let us know in case you are interested in providing a pull request for this, we will try to help you out along the way.

Best regards,
Yana