About API access
System Administrators can allow API access to individual users in order to facilitate integration with third party applications.
Currently users can only generate an API key for one endpoint (a Discussions post) and for one application (Zapier).
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
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.
3. Next, go to the Discussions API access section 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 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.
NOTE—doing 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).