
# Replacing your geocoding API key

## How to deactivate an OpenCage geocoding API key and create a new key

Time for a new geocoding API key? No problem, you can deactivate and old key and create a new key with just a few clicks.

### Background

Your OpenCage geocoding API key is a 32 character alphanumeric string. You set it as the value of the `key` parameter, one of the two [required parameters](https://opencagedata.com/api#required-params), on every request to the OpenCage geocoding API.

Once you [log in](https://opencagedata.com/users/sign_in) you will find your API key in your account dashboard.

### Multiple geocoding API keys per account

Free trial and one-time plan are limited to one key at a time, subscription customers can have multiple keys.

### Disabling or replacing your API key

In your account dashboard you can disable your API key at any time and replace it with a new API key. Please note: usage statistics are tied to your account, not to a specific API key. Creating a new key will not reset your usage limits.

#### Step 1.

Surf to the "Geocoding API" section of your account dashboard. You will see your API key, click on "Settings" for the key you would like to disable.
 ![OpenCage - replacing your geocoding API key](https://assets.opencagedata.com/assets/guides/geocoding-apikey1-fcc2d29d0bb06a4e75829cfbaf5f0b540f3b58ae2696b4cfdb1c935f90780528.png "OpenCage - replacing your geocoding API key")

#### Step 2.

In the Settings panel click on "Disable"
 ![OpenCage - replacing your geocoding API key](https://assets.opencagedata.com/assets/guides/geocoding-apikey2-70e717452f15663dee6601bc3a501a0b83fd1800fb05f1f61bceb59b07cb2bbc.png "OpenCage - replacing your geocoding API key")

#### Step 3.

Close the Settings panel for the now disabled key and you will return to the Geocoding API section of the account dashboard. The old key will still be there, but is now disabled. You will see a button to "Create another API key". Click it.
 ![OpenCage - replacing your geocoding API key](https://assets.opencagedata.com/assets/guides/geocoding-apikey3-5c8b08b7e053cadf320c5d832175382ff257e7d350c0dcbb86c2ee60fe071ce4.png "OpenCage - replacing your geocoding API key")

#### Step 4.

Your new key has now been created and is ready to be used. Happy geocoding.
 ![OpenCage - replacing your geocoding API key](https://assets.opencagedata.com/assets/guides/geocoding-apikey4-842b48e5420d79ee64ad978ce9ecaec9b4cb14c373203d967056f9978290ce10.png "OpenCage - replacing your geocoding API key")

### Protecting your geocoding API key(s)

Please see our [guide to protecting your API key](https://opencagedata.com/guides/how-to-protect-your-api-key).

### Questions or concerns?

Please [contact us](https://opencagedata.com/contact) if anything is unclear. We are here to help.
