REST API v2 keys

Owner or Admins

Before you can use New Relic's REST API or the API Explorer, you must have a REST API key for your New Relic account. For master accounts with sub-accounts, each sub-account must use its own REST API key.

Each account is issued one REST API key. Additionally, each account Admin can have a personal Admin user's API key.

For an overview of the various types of REST API key types, see New Relic REST API key types.

Get REST API or Admin user's API keys

REST API key

To activate API access:

  1. From the account dropdown in the New Relic UI, select Account settings > Integrations > API keys.
  2. Select [regenerate icon] Regenerate REST API key.
  3. Select (Show key) to view the new REST API key.
  4. Copy your REST API key to use with New Relic's REST API.

To regenerate your REST API key:

  1. Select [regenerate icon] Regenerate REST API key.
  2. Confirm the deletion of the previous REST API key by typing DELETION IS FOREVER in the text field.
  3. Select Regenerate.
Admin user's API key

To activate Admin API access:

  1. From the account dropdown in the New Relic UI, select Account settings > Integrations > API keys.
  2. Next to your name, select the regenerate [regenerate icon] icon to generate your Admin user's API key.
  3. Select (Show key) to view your new Admin user's API key.
  4. Copy your Admin user's API key to use with New Relic's REST API.

To regenerate an Admin user's API key:

  1. Select the Admin user's regenerate [regenerate icon] Regenerate REST API key icon.
  2. Confirm the deletion of the previous Admin user's API key by typing DELETION IS FOREVER in the text field.
  3. Select Regenerate.

View REST API or Admin user's API keys

Owner or Admins

To view REST API keys:

  1. From the account dropdown in the New Relic UI, select Account settings > Integrations > API keys.
  2. Select (Show key).

An index of Admin user's API keys appears below the REST API key, with the Admin's full name and the date their key was last used.

  • You can view your own Admin user's API key: Select (Show key) for your name in the Admin index.
  • You can only view other Admin's names. The keys for all other Admins are partially obscured.

Delete an API key

Removing an Admin from the account or changing their role from Admin to User or Restricted user will also remove their Admin user's API key.

To delete a REST API key or an Admin user's API key:

  1. Before you delete an API key, ensure you have the correct account or sub-account.
  2. From the account dropdown in the New Relic UI, select Account settings > Integrations > API keys.
  3. Select the delete [trash can icon] icon for the REST API key or the Admin user's API key.
  4. Confirm the deletion by typing DELETION IS FOREVER in the text field.
  5. Select Delete.

For more help

Recommendations for learning more: