You are here

REST API

The REST API lets you access content in an on-premise repository, and in Alfresco Content Services in the Cloud, from your own applications. The API is RESTful, which means each call is an HTTP request, so you don't even need a programming language to try it out. You can just type a URL address in a web browser.

Getting started

The quickest way to get started is to use our online REST API Explorer, based on the OpenAPI initiative. It gives you full documentation for each endpoint, and a Try it out! button so you can use each method.

You make API requests by sending a URL using one of five HTTP API methods, GET, POST, PUT, DELETE, and OPTIONS. Here's an example of a request to an Alfresco on-premise instance:

http://api-explorer.alfresco.com/alfresco/api/-default-/public/alfresco/versions/1/sites

You can use the REST API Explorer to make this request:

  • In your web browser, navigate to https://api-explorer.alfresco.com/api-explorer/#!/sites/getSites. You'll see full documentation for the GET sites API method, including the query and body parameter formats, and the expected and error response schemas.
  • At the end of the description you'll see the Try it out! button. Press it now.

    You've just made your first Alfresco REST API request. You will see the request URL you've just invoked, the corresponding Curl command, the JSON response body that the Alfresco repository has returned, the HTTP response code, and the response headers:

Note this call returns a list of site entries. All lists returned by the Alfresco REST API are of this format.

CMIS REST API

Use the CMIS REST API to for use cases that require portability.

Sending feedback to the Alfresco documentation team

You don't appear to have JavaScript enabled in your browser. With JavaScript enabled, you can provide feedback to us using our simple form. Here are some instructions on how to enable JavaScript in your web browser.