dotCMS provides a large set of REST (Representational state transfer or "RESTful") web services which provide access to dotCMS content and functionality separately from the dotCMS back-end. dotCMS exposes these web services thru the APIs listed in the documentation below. Many of the documents below provide detailed information about the most commonly used REST services such as saving content using REST. For a full list of dotCMS REST endpoints, please see the REST API Endpoints documentation.
It is important that users and applications using and REST API are authenticated. This is necessary because:
There are a number of different authentication methods you can use with the REST API, which vary in their ease-of-use and security. Therefore, before working with any REST API endpoints, it is recommended that you read the REST API Authentication documentation.
There are over 100 different REST API endpoints, allowing you to save and retrieve both raw and fully rendered content (including files, pages, sites, and all other types of content), publish and unpublish content, manage push publishing bundles, change configuration information, and more.
The REST API Endpoints documentation contains a full list of REST endpoints. In addition, the documentation listed below contains more detailed explanations of many of the most common endpoints and endpoints with specific requirements.
All REST API endpoints are fully integrated with dotCMS permissions. This means that users may only access content through the REST API that they would have access to if they tried to perform the same actions on the content via the dotCMS back-end.