API Tokens Overview (v7.1.0+)

Introduced in v7.1.0, personal API Tokens are a new way of granting Metric Insights REST API access to users without sharing External Application credentials with them. The new interface allows generating personal API tokens for a selected user with a set expiration date. The API token has the exact same privileges as the assigned user and acts on their behalf.  See the notes below on the token generation rules.

NOTES:

  • Power Users can add a new token only for themselves.
    • A Power User must be granted the Use API Tokens privilege to generate API Tokens.
  • Admins can add a new token for themselves and for other non-admin users.
  • Admins can't add a new token for another Admin.

Generate New Personal API Token

Access Admin > System > API Tokens

  1. [+ Token]
  2. Token Name: Enter a name for the Token
  3. Expiration: Set the Token's expiration date and time
  4. Token will represent this user: Select a user on whose behalf the token will act.
    • The token will have the permissions and privileges of the selected user.
  5. [Generate]
  6. [Copy] the token value.
    • Once the pop-up is closed, you will not be able to view it again.
  7. [Download] a text file with the token