> ## Documentation Index
> Fetch the complete documentation index at: https://deepl-c950b784-docs-split-product-family-tabs.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.

<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-split-product-family-tabs/XJBK0sMg_G0RrwwX/_assets/images/limits-and-api-keys-home.png?fit=max&auto=format&n=XJBK0sMg_G0RrwwX&q=85&s=0d0bcd0b17659b334b0f1ec3447fd159" 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-docs-split-product-family-tabs/XJBK0sMg_G0RrwwX/_assets/images/create-api-key-dialog.png?fit=max&auto=format&n=XJBK0sMg_G0RrwwX&q=85&s=a3eed3a5ac70e8f39378ceff9d379431" 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-docs-split-product-family-tabs/XJBK0sMg_G0RrwwX/_assets/images/create-api-key-copy-modal.png?fit=max&auto=format&n=XJBK0sMg_G0RrwwX&q=85&s=85c14251a49c95fefa0abc13acb28c57" 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-docs-split-product-family-tabs/XJBK0sMg_G0RrwwX/_assets/images/copy-api-key.png?fit=max&auto=format&n=XJBK0sMg_G0RrwwX&q=85&s=78bce42017b5d4e2d08b8ae0edd87a9b" 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-docs-split-product-family-tabs/XJBK0sMg_G0RrwwX/_assets/images/rename-key.png?fit=max&auto=format&n=XJBK0sMg_G0RrwwX&q=85&s=1496b12bd04e966129e3bb168c49dfc0" 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-docs-split-product-family-tabs/XJBK0sMg_G0RrwwX/_assets/images/deactivate-key-step-1.png?fit=max&auto=format&n=XJBK0sMg_G0RrwwX&q=85&s=f38a1dcbc9f1ddcbe6b534ce27afd7bc" 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-docs-split-product-family-tabs/XJBK0sMg_G0RrwwX/_assets/images/deactivate-key-step-2.png?fit=max&auto=format&n=XJBK0sMg_G0RrwwX&q=85&s=702cbb072daafbcb40568b580b144cfe" 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-docs-split-product-family-tabs/XJBK0sMg_G0RrwwX/_assets/images/set-key-level-limit-1.png?fit=max&auto=format&n=XJBK0sMg_G0RrwwX&q=85&s=62a1cc1fa1cbd3b2fbcd8f517c577c53" 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-docs-split-product-family-tabs/XJBK0sMg_G0RrwwX/_assets/images/set-key-level-limit-2.png?fit=max&auto=format&n=XJBK0sMg_G0RrwwX&q=85&s=a80093a1bacce20cb29632e0e011d8c5" 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-docs-split-product-family-tabs/XJBK0sMg_G0RrwwX/_assets/images/api-key-permissions-create.png?fit=max&auto=format&n=XJBK0sMg_G0RrwwX&q=85&s=7b5ecdebff4e0df61126f287873ac703" 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-split-product-family-tabs/XJBK0sMg_G0RrwwX/_assets/images/api-key-permissions-edit-dialog.png?fit=max&auto=format&n=XJBK0sMg_G0RrwwX&q=85&s=5ee48dd76cacaf124ac0645a0c02cf17" 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-split-product-family-tabs/XJBK0sMg_G0RrwwX/_assets/images/api-key-permissions-badge-hover.png?fit=max&auto=format&n=XJBK0sMg_G0RrwwX&q=85&s=75208dd8d013498da3467ccda694658c" 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-docs-split-product-family-tabs/XJBK0sMg_G0RrwwX/_assets/images/admin-api-tab.png?fit=max&auto=format&n=XJBK0sMg_G0RrwwX&q=85&s=da98c66274a59bcc43f2c226bd6ffa5a" 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
