> ## Documentation Index
> Fetch the complete documentation index at: https://deepl-c950b784-docs-translation-memory-threshold-minimum.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Managing API Keys in the Account UI

> Create, rename, deactivate, and set usage limits and permissions on DeepL API keys in the account UI.

Manage your API keys in the ["API Keys & Limits" tab](https://www.deepl.com/your-account/keys) when signed into your DeepL API account. A single subscription can have multiple simultaneously active keys: up to 25 on Pro API plans and up to 2 on Free API plans.

This tab has two subtabs: "API Keys" and "Admin API Keys." The sections below — filtering, creating, copying, renaming, deactivating, setting usage limits, and setting permissions — all describe the "API Keys" subtab. See [Manage admin API keys](#manage-admin-api-keys) for how the "Admin API Keys" subtab differs.

<Info>
  To create, deactivate, and limit developer keys programmatically instead, use the [Admin API](/docs/admin/overview#the-admin-api).
</Info>

<Frame caption="The API Keys & Limits tab">
  <img src="https://mintcdn.com/deepl-c950b784-docs-translation-memory-threshold-minimum/Dp3hmnAIKgkwpoEA/_assets/images/limits-and-api-keys-home.png?fit=max&auto=format&n=Dp3hmnAIKgkwpoEA&q=85&s=acb52cbbfebdbe375a7b10bd04b796c0" alt="" width="3776" height="1794" data-path="_assets/images/limits-and-api-keys-home.png" />
</Frame>

## Filter API keys

You can filter API keys by dimensions such as key status, key-level permissions, and consumption. Use this to quickly narrow the key table down to, for example, only active keys or only keys nearing their usage limit.

<Frame caption="Filtering the API key table">
  <img src="https://mintcdn.com/deepl-c950b784-docs-translation-memory-threshold-minimum/Dp3hmnAIKgkwpoEA/_assets/images/filter-api-keys.png?fit=max&auto=format&n=Dp3hmnAIKgkwpoEA&q=85&s=854cc7f1761a91a547b401443f238234" alt="" width="3818" height="1804" data-path="_assets/images/filter-api-keys.png" />
</Frame>

## Create a key

Click "Create key". You can optionally name the key during creation; if you don't, it's named "DeepL API Key" automatically. Naming keys lets you find them later using the search bar on the "API keys" tab.

<Frame caption="Create a new API key">
  <img src="https://mintcdn.com/deepl-c950b784-docs-translation-memory-threshold-minimum/Dp3hmnAIKgkwpoEA/_assets/images/create-api-key-dialog.png?fit=max&auto=format&n=Dp3hmnAIKgkwpoEA&q=85&s=05904d3a11c25caac6ceca187cac0c4f" alt="" width="3820" height="1806" data-path="_assets/images/create-api-key-dialog.png" />
</Frame>

After you confirm, a popup shows the new key. Copy it from this popup to use it immediately, or copy it from the key table at any time.

<Frame caption="Copy an API key immediately after creating it">
  <img src="https://mintcdn.com/deepl-c950b784-docs-translation-memory-threshold-minimum/Dp3hmnAIKgkwpoEA/_assets/images/create-api-key-copy-modal.png?fit=max&auto=format&n=Dp3hmnAIKgkwpoEA&q=85&s=001acb05ac579baf89d4a807b40a39fe" alt="" width="3818" height="1804" data-path="_assets/images/create-api-key-copy-modal.png" />
</Frame>

To create a key that can only access specific endpoints, select **Custom permissions** during creation. See [Set key permissions](#set-key-permissions).

## Copy a key

Click the "Copy" icon next to the key. For security reasons, the full key is never shown in the key table. Both active and deactivated keys can be copied.

<Frame caption="Copy an API key">
  <img src="https://mintcdn.com/deepl-c950b784-docs-translation-memory-threshold-minimum/Dp3hmnAIKgkwpoEA/_assets/images/copy-api-key.png?fit=max&auto=format&n=Dp3hmnAIKgkwpoEA&q=85&s=d901f8417027cb37f16d227d469bee0c" alt="" width="3822" height="1812" data-path="_assets/images/copy-api-key.png" />
</Frame>

## Rename a key

Select "Rename key" from the key's options menu. Both active and deactivated keys can be renamed, and two keys can share the same name.

<Frame caption="Renaming a key">
  <img src="https://mintcdn.com/deepl-c950b784-docs-translation-memory-threshold-minimum/Dp3hmnAIKgkwpoEA/_assets/images/rename-key.png?fit=max&auto=format&n=Dp3hmnAIKgkwpoEA&q=85&s=1fab4d84c4ce9b71d0eaff482395e7b4" alt="" width="3818" height="1810" data-path="_assets/images/rename-key.png" />
</Frame>

## Deactivate a key

<Warning>
  A key stops working immediately when deactivated, and deactivation is permanent: a deactivated key cannot be reactivated.
</Warning>

Select "Deactivate key" from the key's options menu, then confirm.

<Frame caption="Select &#x22;Deactivate key&#x22; from key options">
  <img src="https://mintcdn.com/deepl-c950b784-docs-translation-memory-threshold-minimum/Dp3hmnAIKgkwpoEA/_assets/images/deactivate-key-step-1.png?fit=max&auto=format&n=Dp3hmnAIKgkwpoEA&q=85&s=751c4f34c612e166a0813688f1adf2f7" alt="" width="3794" height="1804" data-path="_assets/images/deactivate-key-step-1.png" />
</Frame>

<Frame caption="Confirm deactivation of key">
  <img src="https://mintcdn.com/deepl-c950b784-docs-translation-memory-threshold-minimum/Dp3hmnAIKgkwpoEA/_assets/images/deactivate-key-step-2.png?fit=max&auto=format&n=Dp3hmnAIKgkwpoEA&q=85&s=c93a5820c7cea8ffb1b591240a089276" alt="" width="3816" height="1810" data-path="_assets/images/deactivate-key-step-2.png" />
</Frame>

## Set a key-level usage limit

Key-level limits cap how much a key can consume in a one-month usage period. You can set a limit in characters (across text translation, document translation, and text improvement), STT minutes, or STS minutes. For example, a key with a 1,000,000 character limit stops consuming at 1,000,000 characters and starts fresh when the next usage period begins. You can see your current usage period dates in the [API Usage tab](https://www.deepl.com/your-account/usage).

To set a limit, select "Set limit" from the key's options menu, activate the limit, choose the unit (characters, STT minutes, or STS minutes), and enter an amount. Setting the limit to 0 prevents the key from consuming any of that unit.

<Frame caption="Select &#x22;Set limit&#x22; from key options">
  <img src="https://mintcdn.com/deepl-c950b784-docs-translation-memory-threshold-minimum/Dp3hmnAIKgkwpoEA/_assets/images/set-key-level-limit-1.png?fit=max&auto=format&n=Dp3hmnAIKgkwpoEA&q=85&s=bc0d0e5288acff71bd785917df2bd1ef" alt="" width="3802" height="1804" data-path="_assets/images/set-key-level-limit-1.png" />
</Frame>

<Frame caption="Activate and specify a limit">
  <img src="https://mintcdn.com/deepl-c950b784-docs-translation-memory-threshold-minimum/Dp3hmnAIKgkwpoEA/_assets/images/set-key-level-limit-2.png?fit=max&auto=format&n=Dp3hmnAIKgkwpoEA&q=85&s=a0d185143452345c9572cefb70ea67d4" alt="" width="3822" height="1812" data-path="_assets/images/set-key-level-limit-2.png" />
</Frame>

As with subscription-level [cost control](/docs/best-practices/cost-control):

* You receive notification emails when a key reaches 80% and 100% of its limit
* The API responds with `456 Quota exceeded` errors once 100% of the limit is reached

To monitor consumption against a limit, check the "Characters consumed" column in the key table or see [Retrieving Usage Data](/docs/admin/retrieving-usage-data).

## Set key permissions

Permissions restrict a developer key to specific endpoints. This section covers the UI steps; to understand how permissions are enforced, see [Understanding API Key Permissions](/docs/admin/api-key-permissions), and for what each scope covers, see [Permission Scopes](/docs/admin/permission-scopes).

To create a scoped key, click "Create key", select **Custom permissions**, choose one or more scopes from the list, and confirm.

<Frame caption="Creating a scoped API key">
  <img src="https://mintcdn.com/deepl-c950b784-docs-translation-memory-threshold-minimum/Dp3hmnAIKgkwpoEA/_assets/images/api-key-permissions-create.png?fit=max&auto=format&n=Dp3hmnAIKgkwpoEA&q=85&s=c8ddd79ef15678e69dd000e980ddde74" width="340" data-path="_assets/images/api-key-permissions-create.png" />
</Frame>

To change permissions on an existing key, select "Edit permissions" from the key's options menu. Choose **All access** to make the key unrestricted, or **Custom permissions** to select specific scopes, then save.

<Frame caption="Choose all access or custom permissions">
  <img src="https://mintcdn.com/deepl-c950b784-docs-translation-memory-threshold-minimum/Dp3hmnAIKgkwpoEA/_assets/images/api-key-permissions-edit-dialog.png?fit=max&auto=format&n=Dp3hmnAIKgkwpoEA&q=85&s=4972e71307adaf55be70a04c67f16076" width="480" data-path="_assets/images/api-key-permissions-edit-dialog.png" />
</Frame>

The "Permissions" column in the key table shows each key's status as a badge. Hover over a badge to see the assigned scopes.

<Frame caption="Hover a badge to view assigned scopes">
  <img src="https://mintcdn.com/deepl-c950b784-docs-translation-memory-threshold-minimum/Dp3hmnAIKgkwpoEA/_assets/images/api-key-permissions-badge-hover.png?fit=max&auto=format&n=Dp3hmnAIKgkwpoEA&q=85&s=0c617d1553429aa5b17eeb257e37e9fa" alt="" width="3786" height="1804" data-path="_assets/images/api-key-permissions-badge-hover.png" />
</Frame>

## Manage admin API keys

On the API Pro, API Growth, and API Enterprise plans, you manage [admin keys](/docs/admin/overview#the-admin-api) on the "Admin API Keys" subtab of the ["API Keys & Limits" tab](https://www.deepl.com/your-account/keys?keyType=admin).

<Frame caption="The Admin Keys subtab">
  <img src="https://mintcdn.com/deepl-c950b784-docs-translation-memory-threshold-minimum/Dp3hmnAIKgkwpoEA/_assets/images/admin-api-tab.png?fit=max&auto=format&n=Dp3hmnAIKgkwpoEA&q=85&s=cecd52f754434f4dbb124e105204641b" alt="" width="3812" height="1812" data-path="_assets/images/admin-api-tab.png" />
</Frame>

Admin keys support the same actions as developer keys: create, copy, rename, and deactivate them from the "Admin API Keys" subtab exactly as described above. The differences:

* Admin keys always end with an `:adm` suffix, which distinguishes them from developer keys
* Unnamed admin keys are called "DeepL Admin Key" by default
* You can create up to 25 simultaneously active admin keys
* Usage limits and permissions don't apply to admin keys
