Skip to main content
All CollectionsIntegrationsAPI Integration
How do I add, remove, deactivate, or replace an API key?
How do I add, remove, deactivate, or replace an API key?

Learn how to manage your API keys in the Gelato Dashboard: add new keys, deactivate, replace, and delete existing ones

Updated over 4 months ago

This article provides a step-by-step guide on how to manage API keys within the Gelato Dashboard, empowering you with the control you need over your API access.


Access and Permissions

Only admins or users with enabled permissions can access and manage API keys.


Managing Your API Keys

The Gelato Dashboard allows you to manage your API keys effectively. Here's how:

  1. Log in to your account on the API Portal.

  2. From the left menu, navigate to Developer > API Keys.

  3. This page will display all your keys, along with their current status.

Screenshot_2022-01-25_080903.png


Adding a New Key

  1. While on the API Keys page, locate and click on the Add API key button situated in the top-right corner.

  2. Provide a unique name for your new key.

  3. Click the Create key to generate your API key.

4.png

A newly generated key will appear. Ensure to copy and store this key securely. You can use the dedicated copy button for this purpose. Remember, once you navigate away from this page, the key won't be visible again.

5.png


Deactivating and Removing a Key

Before removing a key, you need to deactivate it.

  1. Go to the API keys page.

  2. Find the key you want to deactivate.

  3. Click on the three-dot button next to the key.

  4. Choose Deactivate. This will change the key's status.

6.png

Once deactivated, you can remove the key:

  1. From the same three-dot menu, select Delete.

  2. The key will be permanently deleted from your list.

7.png


Replacing an Existing Key

To replace an active API key, follow these steps:

  1. Create a new key using the steps outlined in the "Adding a New Key" section.

  2. Update your system to use the new key.

  3. Verify that orders are being processed correctly with the new key.

  4. Deactivate the old key following the deactivation steps mentioned earlier.

  5. Double-check that orders are still going through successfully.

  6. You can now delete the old key if you wish.

Did this answer your question?