How to manage API access in Jostle – Support Center

About API access

System Admins can allow API access to individual users in order to facilitate integration with third-party applications.

Users can generate API keys for two endpoints (a Discussions post or a new Task).

Notes:

For customers experienced with APIs and interested in accessing data from Jostle for custom integration purposes, Jostle's open API can be found here.
For customers who which to use Jostle's User Provisioning API to help manage their user data, more information can be found here.

About Metadata (Discussions Example)

Since Jostle offers API access for Discussions, the data returned in an API call would be the metadata for any targeted Discussions*. The metadata for a Discussion includes (but is not limited to) the following information:

User IDs of Discussion participants
Discussion title
Discussion type
Target method used
Date created
Date of last post

*includes only those Discussions in which the individual with API access is a Moderator

Enabling Access & Assigning Keys

The following steps are for System Admins to enable and manage the API rights.

Step 1: Enabling API access

1. Go to Admin Settings > Views and Functions > Manage Views and Options

2. Scroll down to API Access and select Enabled

3. Click Save at the bottom of the screen

Step 2: Assigning an API key

1. Go to Admin Settings > Integrations > Manage API Rights

2. Confirm that you have read the disclaimer on this screen

3. Next, go to the Discussions API access section (or, if applicable, the Tasks API access section just below it) and use the Search users field to locate the user you wish to provide with API access. When you select a user they'll automatically be added to the list below.

Once a user is added to the list they'll be able to access the Third party access (API Keys) screen in their Discussions or Tasks (via the gear icon in the action bar) and generate their own API key.

Revoking API access

If at any time you need to revoke API permissions from a user, click the trash can icon to the far right of their name and then confirm your action on the pop-up warning.