---
title: "Java API"
canonical: "https://support.appfire.com/space/CDML/649560824/Java%20API"
format: markdown
---
> Macro (aura-html)


> Macro (excerpt)
> 
> Getting started with Appfire Comala JAVA API plugin - API Services and workflow events

The Appfire Comala Workflows API allows other Confluence plugins (apps) to interact with the Comala Document Management app.

It enables these Confluence plugins to [enquire about and manipulate](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649562848) states, tasks, and approvals and receive notifications of [workflow events](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649923526).

|  |  |  |  |
| --- | --- | --- | --- |
| **[Getting Started](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649595250)**** ****[›](https://comalatech.bitbucket.io/comala-workflows/index.html)** | **[API Documentation ›](https://comalatech.bitbucket.io/comala-workflows/index.html)** | **[API Services](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649562848)**** ****[›](https://comalatech.bitbucket.io/comala-workflows/index.html)** | **[Workflow Events](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649923526)**** ****[›](https://comalatech.bitbucket.io/comala-workflows/index.html)** |

## General Workflow Object Model

All the workflow information is associated to Pages and Blog posts. The higher level entity is a *State*, which can be *Assigned*, and contains *Tasks*, *Approvals* and *Rejections*.

![image](media://2362be21-ee0d-4aca-8df2-e20f6e6575a7)

## Read Only Mode

> ❌ The actions in the JAVA API do not perform any read-only mode validation in Confluence Data Center. Make sure to add the necessary checks in your app before it calls the Comala Document Management Java API if you support read-only mode.

## Java API pages

> Macro (children)

### Java API documentation (Bitbucket)

- [Comala API Documentation (Workflows Developer documentation)](https://comalatech.bitbucket.io/comala-workflows/index.html)

### Atlassian related page

- [How to make your add-on compatible with read-only mode](https://developer.atlassian.com/server/confluence/how-to-make-your-add-on-compatible-with-read-only-mode/)