Confluence Server REST API

Applicable Confluence Server 5.5 and later

The Confluence Server REST API is for admins who want to script interactions with Confluence and developers who want to integrate with or build on top of the Confluence platform.

For REST API documentation, go to Confluence Server REST API reference.

You can find information on the Confluence Cloud REST API here.

CRUD Operations

Confluence's REST APIs provide access to resources (data entities) via URI paths. To use a REST API, your application will make an HTTP request and parse the response. By default, the response format is JSON. Your methods will be the standard HTTP methods: GET, PUT, POST and DELETE. The REST API is based on open standards, so you can use any web development language to access the API.

For some examples of what you can do with the REST API, see Confluence REST API Examples.

Pagination

Confluence's REST API provides a way to paginate your calls to limit the amount of data you are fetching. Read more about this in Pagination in the REST API.

Expansions

Confluence's REST API also provides a way to fetch more data in a single call through REST API Expansions. Read more about this in Expansions in the REST API.

Advanced Search Through CQL

Confluence's REST API provides an advanced search that lets you use structured queries to search for content within Confluence. Your search results will take the same form as the Content model returned by the Content REST API. 

Content and Space Properties

Content and Space Properties are JSON key-value storages that you can access through the REST API. This is a great way, for example, to store metadata about a piece (or pieces) of content. Read more about Content Properties.

REST API Policy

Read the Atlassian REST API Policy for information on compatibility, versioning and deprecation. 

REST API Browser

The Atlassian REST API Browser is a tool for discovering the REST APIs available in Atlassian applications, including Confluence. This is available as part of the Atlassian SDK or can be downloaded from the Atlassian Marketplace.

See Using the REST API Browser.

Was this page helpful?

Have a question about this article?

See questions about this article

Powered by Confluence and Scroll Viewport