How to: The Basics of using Jive's REST API

Document created by David Bastedo on Mar 12, 2014Last modified by amine.bousnina on Aug 4, 2020
Version 5Show Document
  • View in full screen mode



The Jive REST API provides exhaustive functionalities for interacting with your Jive community. This KB gives you a step-by-step guide on how to use the web service endpoints to perform certain functionalities, like searching for content or creating a new user.



  • Verified for version: Jive, Jive Custom 6, 7


Using curl

curl is a command line tool that you can use to consume web services. Here's a general syntax:

curl -X GET "<jiveURL>/api/core/v3/<service>/<resource>?<parm1=value1>&<parm=value2>" --basic --user <username>:<password>

  • curl uses basic authentication by default, so you can leave off "--basic" if you like
  • curl uses GET by default, so you can leave off "-X GET" if you want to. Replace it with "-X POST" or  "-X PUT" depending on the rest call.
  • add -v if you need verbose output (full headers and such)
  • add -o <file> to save the output in a file


To get information on user with username test, while logged in as user jive with password jetLee, you'd need to do:

curl --user jive:jetLee ""


and a more complex example on how to create a subspace using curl:

curl --user jive:jetLee --verbose --header "Accept: application/json" --header "Content-type: application/json" --request POST --data '{  "contentTypes" : [ "blog", "discussions", "documents", "projects" ],  "displayName" : "APINewBieSpace",  "name" : "APINewBieSpace",  "parent" : "",  "type" : "space" }'


Using REST client

You will need to use a REST client application on your computer to run these API calls.  There are a variety of REST client tools available: Many Google Chrome users prefer the Postman extension. We will be using RESTclient extension for Firefox for this guide.

Configuring the RESTClient


  • Download and install RESTClient add-on for Firefox
  • At the top of your web browser, click the RESTClient icon . If you do not see the RESTClient icon, you can click Tools > RESTClient instead.


  • Navigate to Authentication > Basic Authentication. The login window appears; enter username and password and click the Okay button


  • Navigate to Headers > Custom Header. The Request Header window appears; enter the Name and Value as shown below:


  • Now the Headers Pane of your RESTClient should look like this:


So to search contents in your community with respect to creation date, Select GET as the Method, and in the URL section, enter:



Then click the SEND button:



  • A search filter  "filter=search(<search_term>)" must be specified whilst searching/filtering contents on the search/contents endpoint. This is not explicitly stated in the API documentation.
  • Search terms are separated by commas
  • Compound search terms are concatenated by a plus, for example "api tutorial" should be passed as "api+tutorial" (without the quotes)
  • The Response headers tab displays the status of your Request
  • The Response Body tab displays the result of your GET request

A more complex example to create a user account via the RESTclient is described below:

Select POST method, in the URL section, enter:


In the body section, enter:


      "emails" : [ {

          "value" : "",

          "type" : "work",

          "primary" : true,

          "jive_label" : "Email"

      } ],

      "jive" : {

          "password" : "4Jive",

          "username" : "jetme"


      "name" : {

      "familyName" : "Lee",

      "givenName" : "Jet"





Then click the SEND button:



You will see a "201 Created" status code in the Response section - This tells you that the creation was successful.