Watch Live! CamundaCon 2023 is Happening Now

Watch for Free

A look at the fresh REST API

  • Blog
  • >
  • A look at the fresh REST API

30 Day Free Trial

Bring together legacy systems, RPA bots, microservices and more with Camunda Platform 8

Join the Camunda Developer Newsletter

Get the latest events, release notes, and product updates straight to your mailbox.

Camunda BPM comes with a fresh REST API based on JAX-RS. Its goal is to expose the process engine services as broadly as possible. That means we aim to enable you to interact with process engine services via REST with similar expressiveness as in plain Java. With 7.0.0-alpha1, we provide methods such as task querying that already realize our desired degree of detail (similar for process definitions and instances). For future releases, we plan to broaden the scope to reach the afore-mentioned goal.

Use it with a prebuilt distro

In 7.0.0-alpha1 the API covers interactions with process definitions, process instances and tasks as documented on Enough to build your first process applications as demonstrated in Camunda’s Tasklist. In our prebuilt distros, the REST API is enabled by default and is ready to go.

Cool feature: Camunda’s cockpit prototype uses the new methods for aggregated runtime statistics. These give you the number of running instances of BPMN concepts such as processes and activities grouped by process definition and activity respectively. Optionally you can also get the number of failed jobs.

You may also address the several process engines you are running on the platform by prepending /engine/{engine-name} to any of the method’s URLs. If you omit this, the default engine is used.

Embed it in your own JAX-RS application

Got your embedded engine and want to quickly add REST capabilities to it? You may embed the RESTful resources in your own JAX-RS application with little configuration if you run on Resteasy and have jackson-jaxrs on your classpath. Pick up the REST resources by adding the following Maven dependency:


Then you can choose which of the resources you want to include. Have a look here to see how this can be done. (The alternative is to use a JAX-RS implementation provided by your application server.)

Being an alpha release, we are aware that essential features such as authentication are still missing. However, this is on our roadmap to 7.0.0 final, so stay tuned and explore the docs meanwhile!

Try All Features of Camunda Platform

Related Content

Get all the latest updates and recaps of what's happening in this live blog of CamundaCon 2023.
Learn how Connectors from a process orchestration solution like Camunda can pair with RPA tools to make automation easier.
Why Camunda? Learn how real estate invester Heimstaden utilizes Camunda to orchestrate their tenant support ticketing system.