Come for the products,
stay for the community

The Atlassian Community can help you and your team get more value out of Atlassian products and practices.

Atlassian Community about banner
Community Members
Community Events
Community Groups

Confluence REST APIs vs Java development for dynamically creating spaces and pages


I have developed a small DITA plugin that converts DITA content to Confluence format and creates Confluence pages using REST APIs. It does its job ok. Recently, we faced an issue after upgrading to the latest version of Confluence. The pages would not be created unless we refresh pages manually in Confluence. That got me thinking.

Is there any other way to dynamically create Confluence pages and spaces?

Uses cases:

  1. Publish dita maps to Confluence
  2. When a dita topics are updated, publish the map to Confluence and update the pages without deleting the space - we would like to preserve comments. And we would like to maintain the source in DITA.
  3. Convert a bunch of dita maps as a Confluence space

I am able to achieve most of these using REST APIs. But it's slow and then new upgrades can cause problems. 

Is Java based development a better option in this case? If yes, could you please redirect me to some resource that could get me started?


1 comment

Minh Tran Atlassian Team Jan 21, 2020

@antony terrence REST api is a good option for creating spaces / pages

However, you can also use the java api to do such thing

You can check out for how to develop the Confluence plugin and its api

@Minh Tran @I am not trying to build a confluence plug-in. I am trying to build a DITA plug-in that will push content to Confluence server. Is that possible without REST APIs

Minh Tran Atlassian Team Jan 22, 2020

I am not sure what DITA plug-in is. Is that a plugin from another system?

If yes, REST api might be the only option for you if you want to migrate data that system into Confluence

Another option is to write Confluence plugin but connect to that DITA system database and do the migration via Confluence Java api 

@Minh Tran DITA is an external system. It generates XHTML pages. We need to import those pages into Confluence programmatically. Also, the TOC should be retained after posting the pages to Confluence. Is there any other way to do it efficiently than REST APIs?


Log in or Sign up to comment
Community showcase
Published in Confluence

Confluence: Where work and wellness meet

Feeling overwhelmed by the demands of work and life? With a 25% increase in the prevalence of anxiety and depression worldwide during the pandemic, for most of us, it’s a resounding yes . 🙋‍♀️ ...

916 views 12 27
Read article

Community Events

Connect with like-minded Atlassian users at free events near you!

Find an event

Connect with like-minded Atlassian users at free events near you!

Unfortunately there are no Community Events near you at the moment.

Host an event

You're one step closer to meeting fellow Atlassian users at your local event. Learn more about Community Events

Events near you