Follow

Managing API Rights

 

 

About API access

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

Currently users can generate API keys for two endpoints (a Discussions post or a new individual task in Tasks). However, at this time only the Discussions endpoint is integrated with a third-party application (Zapier).

NOTEFor customers experienced with API and interested in accessing data from Jostle for custom integrations purposes, Jostle's publicly available open API 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

 

Step 1: Enabling API access

1. Go to  Admin Settings > Views and functions > Manage views and powerups.

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. 

api01.png

 

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.

api03.png

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.

api04.png

NOTEdoing this will revoke all API keys* issued to that user, meaning that anything created with an application using those keys will no longer work.

*as mentioned above, currently users can only generate a key for one endpoint (a Discussions post) and for one application (Zapier).

 

 

Was this article helpful?
1 out of 1 found this helpful
Have more questions? Submit a request

0 Comments

Please sign in to leave a comment.