> ## Documentation Index
> Fetch the complete documentation index at: https://docs.honeycomb.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Manage Team API Keys

> Create and manage Team-level Management API keys to control API keys across all Environments in your Team and set the scopes each key can access.

Management API Keys allow you to manage API Keys at the Team level, which includes all API Keys for the Environments associated with your team.

Create and manage these team-scoped Management API Keys through the Honeycomb UI.
We require you to manually create a Management API Key.
When you create a Management API Key, you assign it a set of scopes, which determine what actions the API Key can perform in the associated Team.

Use Management API Keys to authorize the Key Management API.
Refer to the [Key Management API documentation](/api/key-management/) for details.

Any programmatic request sent to Honeycomb must use an API Key, but most Honeycomb APIs operate at the Environment level and require a [Configuration Key](/configure/environments/manage-api-keys/#find-api-keys) for resource management.
To learn more about using API Keys, visit [Best Practices for API Keys](/get-started/best-practices/api-keys/).

## Find Management API Keys

To find your existing Management API Keys:

1. Log in to the Honeycomb UI.

2. From the navigation bar, select **Account**, and then **Team Settings**.

3. Select the **API Keys** view.

## Create Management API Key

<Info>
  To create a Management API Key, you must be a [Team Owner](/configure/teams/manage-permissions/).
</Info>

<Warning>
  For security reasons, you can access the secret portion of your Management API Key only while creating it.
  You may be able to use the information you retrieve in this section to identify a key or its settings, so you can retrieve it from the safe location in which you previously stored it.
</Warning>

To create your API Key:

1. Log in to the Honeycomb UI.

2. From the navigation bar, select **Account**, and then **Team Settings**.

3. Select the **API Keys** view.

4. Select **Create Management API Key**.

5. In the **Create Management API Key** modal, enter the details for your API Key:

   | Field  | Description                                                                                                                                                |
   | ------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------- |
   | Name   | Label for the API Key. Used to identify this key in the Honeycomb UI.                                                                                      |
   | Scopes | Actions this key is allowed to perform on Honeycomb resources. For a full list of available scopes, visit [Management Key Scopes](#management-key-scopes). |

   <Warning>
     Choose scopes carefully; they are permanent. To change scopes, you must delete the API Key and create a new one.
   </Warning>

6. Select **Create**.

7. Copy your **Secret** and save it to a secure location.
   Honeycomb returns it only upon creation.

   <Warning>
     Store your API keys securely and never check them into version control systems, such as Git.
   </Warning>

8. Select **I've copied the secret**.

9. Optionally, copy your **Key ID**.
   You will need both your **Key ID** and **Secret** to authenticate requests to the API.
   Your **Key ID** is always available after creation, but your **Secret** is not.

Your new API Key appears in the list of keys.
To learn how to use your new key, visit [API Documentation: Authentication](/api/authentication).

## Disable Management Keys

<Info>
  To disable a Management Key, you must be a [Team Owner](/configure/teams/manage-permissions/).
</Info>

To disable your Management Key:

1. Log in to the Honeycomb UI.

2. From the navigation bar, select **Account**, and then **Team Settings**.

3. Select the **API Keys** view.

4. In the list, locate the Management Key that you want to disable, and select **Details** to view its settings.

5. Locate the **Enable** checkbox, and deselect it.

6. Select **Save**.

Your Management Key will appear grayed out in the list, but it may take several minutes for the process to complete.

## Delete Management Keys

<Warning>
  Management Key deletion is permanent, so make sure you really want to delete your Management Key before doing so.

  To delete a Management Key, you must be a [Team Owner](/configure/teams/manage-permissions/).
</Warning>

To delete your Management Key:

1. Log in to the Honeycomb UI.

2. From the navigation bar, select **Account**, and then **Team Settings**.

3. Select the **API Keys** view.

4. In the list, locate the Management Key that you want to delete, and select **Details** to view its settings.

5. Select **Delete**.

6. In the **Delete Management API Key?** modal, enter the name of the Management Key (located above the field).

7. Select **Delete**.

Your Management Key will no longer appear in the list, but it may take several minutes for the process to complete.

## Management Key Scopes

You can control the actions that a Management API Key may perform in your Team at a more granular level.

<Note>
  You cannot change scopes assigned to a Management Key after the key has been created.
  Management Keys can be deleted.
</Note>

### API Keys

| Scope                | Description                                                                             |
| -------------------- | --------------------------------------------------------------------------------------- |
| `api-keys:read`      | Grants `list` and `view details` to the team's API Keys.                                |
| `api-keys:write`     | Grants `create`, `list`, `update`, `delete` and `view details` for the team's API Keys. |
| `environments:read`  | Grants `list` and `view details` to the team's Environments.                            |
| `environments:write` | Grants `create`, `list`, `update`, and `view details` for the team's Environments.      |