# Manage V1 API Keys

{% hint style="danger" %}
Mindee V1 API keys are **not compatible** with [Mindee V2](https://app.gitbook.com/o/d9Gz7nSZ4m59bFLf6f4m/s/u5bStlX8nv4b9z4GXB2S/) APIs.
{% endhint %}

## Overview

You will need to create a V1 API key to make API requests on Mindee V1.

All Products can be accessed using a single API key.

This includes [docTi](https://docs.mindee.com/v1/docti) and all [Off-the-Shelf](https://docs.mindee.com/v1/off-the-shelf-products) products such as Financial Document API, Invoices API, Receipts API, Bank Account Details API, \&c...

## Create Your V1 API Key

Once logged in, you'll land on **My APIs** page where you will have access to the APIs you are using and a button **Document Catalog** to explore the off-the-shelf APIs proposed by Mindee.

<figure><img src="https://126655343-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2al1MDqAP9Dg9iDRjkWg%2Fuploads%2F0ue3BeeyXEyQI4OSpqiL%2F593d093-My_APIs.png?alt=media&#x26;token=289cfadf-d845-421f-babf-a080bf778012" alt="" width="563"><figcaption></figcaption></figure>

1. Click on API keys on the left menu, or click on the button below:\ <a href="https://platform.mindee.com/api-keys" class="button primary">Go to API Keys</a>
2. Click on **Create a new API key** button.

<figure><img src="https://126655343-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2al1MDqAP9Dg9iDRjkWg%2Fuploads%2Fgit-blob-be8e110c4b1eab1992b088e99998f598b7e8708b%2F5b03fb4-Empty_keys.png?alt=media" alt="" width="563"><figcaption></figcaption></figure>

3\. Give your API key a desired name and click on **Create API key**.

<figure><img src="https://126655343-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2al1MDqAP9Dg9iDRjkWg%2Fuploads%2Fgit-blob-29bc10bacec378529da79d6d2f28cddc96fe43cf%2F855eae8-Screenshot_2022-07-12_at_16.04.18.png?alt=media" alt="" width="563"><figcaption></figcaption></figure>

4. Your API key will be created showing the date and time it was created. You can then copy your API key and paste it into your development environments, applications, or command-line tools.

<figure><img src="https://126655343-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2al1MDqAP9Dg9iDRjkWg%2Fuploads%2Fgit-blob-7779eb263e6edc5a370805e8a28eb7c383184edb%2F80c9efb-Screenshot_2022-07-13_at_11.26.09.png?alt=media" alt="" width="563"><figcaption></figcaption></figure>

## Manage V1 API keys

Within the API keys section, you can create multiple API keys according to your needs, retrieve, and delete your API keys.

### Set up Another V1 API Key

You may want to use different keys for different environments, for example, one key for development, another for staging, another for production, etc. They can be different scenarios in this regard.

To add another API key, click on the **Create a new API key** button.

<figure><img src="https://126655343-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2al1MDqAP9Dg9iDRjkWg%2Fuploads%2Fgit-blob-ff87d820d6f3318a119e1f6c60ce533fe0a79b2f%2Fe480907-Screenshot_2022-07-13_at_12.00.13.png?alt=media" alt="" width="563"><figcaption></figcaption></figure>

You can create multiple keys according to your needs and each of these keys can work across all APIs.

<figure><img src="https://126655343-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2al1MDqAP9Dg9iDRjkWg%2Fuploads%2Fgit-blob-48db72391ec2f900fb91a88971fb4e3d36abb91c%2F3075a76-List_of_keys.png?alt=media" alt="" width="563"><figcaption></figcaption></figure>

### Delete a V1 API key

{% hint style="warning" %}
It is important to note that if you delete your API keys, it cannot be undone.
{% endhint %}

Once your API key is created, the API key can be deleted, but not modified.

1. Click on the delete icon located on the left.

<figure><img src="https://126655343-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2al1MDqAP9Dg9iDRjkWg%2Fuploads%2Fgit-blob-01d15d52cdc13e9adc828a42fb464be4156ab133%2F2d91f45-Screenshot_2022-07-13_at_11.26.09.png?alt=media" alt="" width="563"><figcaption></figcaption></figure>

2. A dialog box will pop out, type the name of your API key and click on the **Delete API** button.

<figure><img src="https://126655343-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2al1MDqAP9Dg9iDRjkWg%2Fuploads%2Fgit-blob-5ba8b167e880f5ff02bee1199dd38bf3f43923df%2F4fb842a-Screenshot_2022-07-13_at_11.57.03.png?alt=media" alt="" width="563"><figcaption></figcaption></figure>

## Best Practices for Using API Keys

1. Keeping your API keys in your environment variables is a good and safe practice.
2. Don’t store your API key directly in your code.
3. Avoid exposing your secret API keys on GitHub, on the client-side, or in any other location that is open to the public.
4. Periodically change your API keys. To do so:
   * Create a new API key,
   * Update your application with the new API key.
   * Delete the old API key.
