Skip to content

Update new-relic-api-keys.mdx #22313

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 1 commit into
base: develop
Choose a base branch
from
Open

Update new-relic-api-keys.mdx #22313

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
8 changes: 6 additions & 2 deletions src/content/docs/apis/intro-apis/new-relic-api-keys.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -163,9 +163,13 @@ To get started with API keys:
You can manage most API keys from the [API Keys UI page](https://one.newrelic.com/api-keys) located in the [user menu](/docs/accounts/accounts-billing/general-account-settings/intro-account-settings/#user-menu) when you click <DNT>**API keys**</DNT>.
You can also [use NerdGraph to manage keys](/docs/apis/nerdgraph/examples/use-nerdgraph-manage-license-keys-user-keys)

During the key creation process, we temporarily provide you with the entire key. However, once the key is created, only the first 8 characters are displayed in the API Keys UI.
When creating an Ingest type key, we temporarily provide you with the entire key. However, once the key is created, only the first 8 characters are displayed in the API Keys UI.

If you need to retrieve the full key after creation, click the ellipses in the API Keys UI, copy the key ID, and [use NerdGraph to query for the full key.](/docs/apis/nerdgraph/examples/use-nerdgraph-manage-license-keys-user-keys/#query-keys).
When creating a User type keyfor your own user, we temporarily provide you with the entire key. However, once the key is created, only the first 8 characters are displayed in the API Keys UI.

When creating a User type key for another user you will only ever see the truncated version of the key in the API Key UI and via Nerdgraph.

If you need to retrieve the full key after creation, for Ingest keys and User keys that belong to your user, click the ellipses in the API Keys UI, copy the key ID, and [use NerdGraph to query for the full key.](/docs/apis/nerdgraph/examples/use-nerdgraph-manage-license-keys-user-keys/#query-keys).
Comment on lines +166 to +172
Copy link
Contributor

@WriteMayur WriteMayur Dec 2, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggestion:

When you create an Ingest key or User key:

  • If the key is for your own use (Ingest key or User key), the full key is visible immediately after creation. Once you leave the screen, only the first 8 characters are displayed in the API Keys UI.

  • If the key is for another user, the full key is never displayed in the UI.

To retrieve the full key after creation:

  1. For your own Ingest keys and User keys, click the ellipses (...) next to the key in the API Keys UI, and then copy the Key ID.

  2. Use the copied Key ID to query for the full key via NerdGraph.


## Recommendations for managing API keys [#security-practices]

Expand Down
Loading