Version 5

    Summary

     

    Once a Social Group is created in Jive, administrators are unable to change the URL. The article aims to walk a user through how to change the URL of a Jive Social Group by using the Jive v3 API.

     

    If you have not used the Jive v3 API in the past, it is recommended that you first read How to: The Basics of using Jive's REST API

     

     

    Versions

    • Verified for version: Jive & Jive Custom 6, 7
    • Document has been tested against Jive Core API v3

     

     

    Details

     

    Social Group URLs cannot be changed through the Jive web interface, or through the admin console. The only way the URL of a Social Group can be changed, as of Jive Custom 7, is through use of the Jive Core API v3.

     

    Follow the steps defined below to walk through the process of updating the URL

     

    1. Install a REST Client that you can use to make Jive API calls
    2. Identify the URL of the group you wish to change
    3. API Call 1: Run a Search API call to find the Places ID for the specific group you're targeting
    4. API Call 2: Run a Places API call to find the existing Group data points
    5. API Call 3: Run another Places API call to update the URL of the group
    6. Clear all Jive server Cache via Admin Console > System > Settings > Caches
    7. Confirm your new URL is working

     

    In the example below we will be taking a social group that has the URL of /groups/old-group-name and changing it to /groups/new-group-name

     

    Steps

     

    1) Install a REST Client that you can use to make Jive API calls

     

    For the purposes of this article you will need to be able to successfully run API calls as an authenticated Jive user.  This functionality is covered in this article: How to: The Basics of using Jive's REST API

     

     

    2) Identify if the URL of the group you wish to change.

     

    In this example it is "old-group-name".

     

    1.png

    3) API Call 1: Run a Search API call to find the Places ID for the specific group you're targeting

     

    Here we will run our first API call. We will use the Search API to look up the "Place ID" of this particular group.

     

    Run the following API call:

     

    HTTP Method: GET

    URL: [JIVEURL]/api/core/v3/search/places?filter=search(old-group-name)

          

    2.png

     

     

    In the "Raw" response text we should have a set of JSON text.  Search the results for a section called "self". It should have a URL that matches the following pattern:

     

    [JIVEURL]/api/core/v3/places/####

     

    In this example, the API resources for the "Old Group Name" social group is http://localhost:8080/api/core/v3/places/1011

     

    3.png

     

    Please note, if you are receiving a "403 Unauthorized" error when making an API call, please be sure that you are correctly setting the "Authorization" and "Content-Type" headers.  See How to: The Basics of using Jive's REST API for more details on this.

     

    You can also reference Finding the Content ID and Place ID using Jive v3 API to find the correct Place ID for your social group.

     

     

    4) API Call 2: Run a Places API call to find the existing Group data points

    HTTP Method: GET

    URL: [JIVEURL]/api/core/v3/places/1011

          

    4.png

     

    In the Response text, you will want to note the Social Group's "groupType" JSON value, as you'll need to provide this value when you update the group.  By Default this will be set to "OPEN", for an Open Group Type, but it may be set to something else, like "MEMBER_ONLY", "PRIVATE", or "SECRET"

     

     

    5) API Call 3: Run another Places API call to update the URL of the group

     

    Run the following API Call:

     

    HTTP Method: PUT

    URL: [JIVEURL]/api/core/v3/places/1011

          

     

    Sample Data Payload:

     

    {

      "groupType" : "OPEN",

      "displayName" : "new-group-name",

    }

          

     

    Be sure to keep the "groupType" value the same as what was found in Step 4 above.

     

    Change the "displayName" value to be the text you want for the new group URL.

     

    You should see the API call generate a "200 OK" status.  This means that your new URL is available for use.

     

    5.png

     

     

    5) Clear all Jive server Cache via Admin Console > System > Settings > Caches

     

    You will need to clear your system caches at this point, otherwise users may still be able to access the group from the old URL, which can cause confusion.  Please note that Cloud customers will have to file a case with Jive Support as only On-Premise and Hosted customers can clear their own application caches.

     

    An Admin can do this by going to Admin Console > System > Settings > Caches and clicking the top Checkbox and scrolling down and clicking the "Clear Selected" button.

     

     

    6.png

     

    7) Confirm your new URL is working

     

    At this point your group is now accessible from your new URL.  You can verify this by going to [JIVEURL]/places , finding your social group, and inspecting the URL of the link:

     

    7.png

     

     

    8.png

     

     

    jive-ask-a-question.png