Manage API keys
Overview
API keys are an important part of the platform. They let our users automate actions and provide technical access without going through the UI.
An API key is not only a unique identifier and a secret token for authentication, but it can also work as a mean to give an access that is more specific to the identity that is associated with it.
Some bricks within the app also require the creation of an API key such as our CTI interconnection with third-party tools and playbooks.
API keys listing
To access the list of generated API keys in your community, you have to click on your avatar, go to Managed communities and click on the API keys
tab.
On this view, you can:
- Search for an API key by using the search bar on top of the table
- Filter your API keys by status:
Active
,Revoked
,All
- Add a new API Key by clicking on the button
+ API key
The table that lists API keys has various columns where you can find the following:
- Name of the API key
- Description of the API key
- ID of the API key that can be copied with the button icon
copy
- Creation date
- Roles linked to the API key
- Status:
Active
,Revoked
,All
- A button to edit the API key
Create an API key
To create a new API key, you’ll have to:
- Click on the
+ API key
button - Give a name and a description to your key (description should be more than 10 characters and less than 100 characters)
- Select one or more roles to associate with your key. For instance, if you want to use your key to retrieve information from the Intelligence Center, please select the role
ic_viewer - Intelligence Center Read-Only
- Click on
Save
Note
The key will only be displayed once. We recommend you to save it into a vault.
Revoke an API Key
Revoking an API key will make it unusable. It’s rather easy to do but keep in mind that it’s an action that cannot be reversed.
To revoke an API key, please proceed with the following steps:
- Go to
Managed communities
page by clicking on your avatar in the upper right of the screen - On the API key tab, click on the
Edit
button - Then revoke the API key by clicking on the red button
Revoke