> ## Documentation Index
> Fetch the complete documentation index at: https://docs.aseeflow.org/llms.txt
> Use this file to discover all available pages before exploring further.

# REST API

To enable the [REST API](/reference/rest) you can use the following starter in your `pom.xml`:

```xml theme={null}
<dependency>
  <groupId>org.aseeflow.bpm.springboot</groupId>
  <artifactId>aseeflow-bpm-spring-boot-starter-rest</artifactId>
  <version>1.0.0</version>
</dependency>
```

By default the application path is `engine-rest`, so without any further configuration you can access the api at `http://localhost:8080/engine-rest`.

Because we use jersey, one can use spring boot's [common application properties](http://docs.spring.io/spring-boot/docs/current/reference/html/common-application-properties.html).
For example, to change the application path, use

```properties theme={null}
spring.jersey.application-path=myapplicationpath
```

To modify the configuration or register additional resources, one can provide a bean which extends from
`org.camunda.bpm.spring.boot.starter.rest.CamundaJerseyResourceConfig`:

```java theme={null}
@Component
@ApplicationPath("/engine-rest")
public class JerseyConfig extends CamundaJerseyResourceConfig {

  @Override
  protected void registerAdditionalResources() {
    register(...);
  }

}
```