Managing API Keys

All Moogsoft APIs require an API key, as well as the following integrations:

Go to Settings > API Key Management. to view, create, and revoke your API keys.

Important notes

  • Users do not have API keys by default. You must create a key for yourself before you can use an API or API-based integration.

  • Each API key is associated with the user who created that key. Operators can create and access their own keys. Administrators and Owners can view and revoke any keys in the system.

  • You can create multiple keys for yourself. This is good practice if you want to set up multiple inbound integrations: use a separate API key for each data stream.

  • The operations available to a you depend on your role and permissions. If you have Operator permissions, you can view correlations by sending a GET to the correlations API endpoint. However, you cannot create correlations by sending a POST. See Managing Moogsoft Users.

  • If you delete a user, all API keys associated with that user are deleted as well.

Creating an API key

  1. Go to Settings > API Key Management.

  2. Click the Create API Key (plus sign) button on the right.

  3. Enter a name and description for the key, then click Create.

Note

Copy and save the key in a secure text file immediately after you create the key. This is the only time you can view the key directly in the Moogsoft UI.

Revoking API Keys

  1. Go to Settings > API Key Management.

  2. Select the checkmarks next to the keys of interest.

  3. Click Revoke. The key will get revoked within 5 minutes.