> ## Documentation Index
> Fetch the complete documentation index at: https://developers.deepl.com/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.

<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/ACNi6B4r-fr8qnE5/_assets/images/limits-and-api-keys-home.png?fit=max&auto=format&n=ACNi6B4r-fr8qnE5&q=85&s=574284dcd2dc920a769749abc76f42f9" alt="" width="3820" height="1712" data-path="_assets/images/limits-and-api-keys-home.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/ACNi6B4r-fr8qnE5/_assets/images/create-api-key-dialog.png?fit=max&auto=format&n=ACNi6B4r-fr8qnE5&q=85&s=ba18d8c16eb2ab4c23ace6fad2c69241" alt="" width="3818" height="1726" 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/ACNi6B4r-fr8qnE5/_assets/images/create-api-key-copy-modal.png?fit=max&auto=format&n=ACNi6B4r-fr8qnE5&q=85&s=fe04ce80b290a5897c6c7e0534514676" alt="" width="3818" height="1718" 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/ACNi6B4r-fr8qnE5/_assets/images/copy-api-key.png?fit=max&auto=format&n=ACNi6B4r-fr8qnE5&q=85&s=451ee54ec06a3069a55d76f4037c51a2" alt="" width="3788" height="1732" 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/ACNi6B4r-fr8qnE5/_assets/images/rename-key.png?fit=max&auto=format&n=ACNi6B4r-fr8qnE5&q=85&s=a3c9cc7ba1e6760daef92f1fcf433261" alt="" width="3830" height="1706" 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/ACNi6B4r-fr8qnE5/_assets/images/deactivate-key-step-1.png?fit=max&auto=format&n=ACNi6B4r-fr8qnE5&q=85&s=7273c7a1ec6ec9a7cace28cce0551020" alt="" width="3820" height="1712" data-path="_assets/images/deactivate-key-step-1.png" />
</Frame>

<Frame caption="Confirm deactivation of key">
  <img src="https://mintcdn.com/deepl-c950b784/ACNi6B4r-fr8qnE5/_assets/images/deactivate-key-step-2.png?fit=max&auto=format&n=ACNi6B4r-fr8qnE5&q=85&s=69e468e8ec4a9d770f0abe2a94f9d716" alt="" width="3820" height="1712" data-path="_assets/images/deactivate-key-step-2.png" />
</Frame>

## Set a key-level usage limit

Key-level limits cap the total characters (across text translation, document translation, and text improvement) a key can consume in a one-month usage period. 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, and enter a character amount. Setting the limit to 0 prevents the key from consuming any characters.

<Frame caption="Select &#x22;Set limit&#x22; from key options">
  <img src="https://mintcdn.com/deepl-c950b784/ACNi6B4r-fr8qnE5/_assets/images/set-key-level-limit-1.png?fit=max&auto=format&n=ACNi6B4r-fr8qnE5&q=85&s=0c9fe26325ad9aa00ad33ba6b6878316" alt="" width="3820" height="1728" 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/ACNi6B4r-fr8qnE5/_assets/images/set-key-level-limit-2.png?fit=max&auto=format&n=ACNi6B4r-fr8qnE5&q=85&s=332675bc592eb8607835381b38f55b1a" alt="" width="3824" height="1728" 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/2IRn9vN4mrLVwBTh/_assets/images/api-key-permissions-create.png?fit=max&auto=format&n=2IRn9vN4mrLVwBTh&q=85&s=2c0cb50ea984d49dcac85d20c9e34992" 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/2IRn9vN4mrLVwBTh/_assets/images/api-key-permissions-edit-dialog.png?fit=max&auto=format&n=2IRn9vN4mrLVwBTh&q=85&s=66f22d1aa5ae0a5eeeff5a5702f7e070" 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/2IRn9vN4mrLVwBTh/_assets/images/api-key-permissions-badge-hover.png?fit=max&auto=format&n=2IRn9vN4mrLVwBTh&q=85&s=77ba49fbfd7e452393fe8a970002bd88" alt="" width="2260" height="314" data-path="_assets/images/api-key-permissions-badge-hover.png" />
</Frame>

## Manage admin API keys

If your account has [Admin API access](/docs/admin/overview#the-admin-api), you manage admin keys separately in the ["Admin Keys" tab](https://www.deepl.com/your-account/admin).

<Frame caption="The Admin Keys tab">
  <img src="https://mintcdn.com/deepl-c950b784/OnHfwyeOjDg0aJdt/_assets/images/admin-api-tab.png?fit=max&auto=format&n=OnHfwyeOjDg0aJdt&q=85&s=68faaa538d4dfad54b58a4bb9c782e2b" alt="" width="1871" height="585" 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 Keys" tab 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 on any plan with Admin API access
* Usage limits and permissions don't apply to admin keys
