# Updating your API version

## Updating your API version on all keys

Use the **Update version on all keys** button on the Keys and versioning pane to [select a version and update all keys to that version](https://docs.digitalriver.com/digital-river-api/administration/dashboard/developers/api-keys/updating-your-api-version). You can select to update all API keys to the latest API version or a previous API version. When you update all keys, the API version column for standard keys and restricted keys displays the version you selected.

<figure><img src="https://334437993-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LqH4RJfLVLuHPXuJyTZ%2Fuploads%2FjAv3i3lG4TWuYXTKefZl%2F1%20Update%20versioning.png?alt=media&#x26;token=9ae00ac1-076f-4e9a-a02f-ac2979fb3e8e" alt=""><figcaption></figcaption></figure>

1. Select the environment you want to update using the **Test/Production** toggle. **Best Practices**: Install the new version in the [test environment](https://docs.digitalriver.com/digital-river-api/administration/dashboard/test-and-production-environments) first.
2. Click the **Update version on all keys** button to open the Update all keys dialog box.
3. Click the **Release notes** link to review the latest changes. If necessary, apply the changes to your system before you continue.
4. Select a version from the **API Version** drop-down list and click **Update all keys in test mode** or **Update all keys in production mode.**\
   \
   ![](https://334437993-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LqH4RJfLVLuHPXuJyTZ%2Fuploads%2FdbL4jH5rY63u5EvrUwHr%2F2%20Update%20versioning%20modal%201.png?alt=media\&token=9e590116-1138-4a8a-b103-79bd503ee35f)

{% hint style="warning" %}
The key will not be available for immediate use. It can take up to 10 minutes for the key to fully propagate.
{% endhint %}

When the update is finished, the Standard and Restricted keys tables display the same API version for each restricted key.

<figure><img src="https://334437993-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LqH4RJfLVLuHPXuJyTZ%2Fuploads%2FydUi7QCvSiZ21gXJcEv6%2F3%20Standard%20and%20restricted%20with%20new.png?alt=media&#x26;token=b9c913d0-fdee-49fd-ab95-bfc94232207a" alt=""><figcaption></figcaption></figure>

## Release notes

The Release Notes link takes you to the list of API-breaking changes. New additions and non-breaking changes don’t need a new API version and will not appear on this list.
