# Manage API Keys

The **Manage API Keys** view of the Emporix Developer Portal is the place where you access the API keys connected to your tenants. API keys allow you to access API from either business or a customer's perspectives.

<figure><img src="/files/GO5tlHU4ymB0VPzcA6Ey" alt=""><figcaption></figcaption></figure>

When you create an Emporix tenant, you obtain keys to the following types of :

| API type           | Description                                                                                                                                   |
| ------------------ | --------------------------------------------------------------------------------------------------------------------------------------------- |
| **Emporix API**    | Used to access and manage your tenant's resources. With this key, you have access to all services and scopes within the application.          |
| **Storefront API** | Used to access storefront application to perform basic e-commerce actions like browsing products, viewing prices, or adding products to cart. |
| **Custom API**     | Used to define your own keys for separate services and with specific scopes.                                                                  |

To authorize API requests, you need `Client ID` and `Secret` of a specific API key depending on the request you want to send. You can easily copy the credentials with the **copy** icon or view the `Secret` with the **preview** icon. Also, it is possible to regenerate the API keys by choosing the **renew** option.

<div align="left"><figure><img src="/files/Xf9H3KkRtdoWVhoXYrrx" alt="" width="116"><figcaption></figcaption></figure></div>

## Custom API keys

You can create your custom API keys for various purposes. It is possible to define separate API keys for different services that contain some specific scopes. This way the application stays more secure. The custom API keys are assigned to the specific tenant.

### Creating custom API keys

1. If you don't have any custom API keys, in the **Manage API Keys** view choose the **Create scopes** in the **Custom API** row. Once you have already defined some API keys and want to define more scopes, expand the **Custom API** and choose **Add custom API**.
2. Enter the name for your custom keys and select the scopes of your interest. You can choose scopes from different services.

   <figure><img src="/files/FzVE2oHwA6adgRZ0ryts" alt=""><figcaption></figcaption></figure>
3. Confirm with **Generate** and the created group appears under **Custom API**.

   <figure><img src="/files/36sec5iETuIcmSRtLTfd" alt=""><figcaption></figcaption></figure>

## Quick start sample

For easier start of working with API keys, you get a preview of sample requests. Choose the **Get started** option next to the selected API key to get a preview of an example request.

<figure><img src="/files/im7ydQcr6VQrfPmeMmAB" alt=""><figcaption></figcaption></figure>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://developer.emporix.io/ce/getting-started/developer-portal/manage-apikeys.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
