# 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](/digital-river-api/administration/dashboard/developers/api-keys/updating-your-api-version.md). 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="/files/lJoPoKGXoM06OqMh3L8U" 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](/digital-river-api/administration/dashboard/test-and-production-environments.md) 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.**\
   \
   ![](/files/bUe4DQwDiuAe9V7Di0jN)

{% 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="/files/ASLnZIzKoiLjb6NRD6rk" 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.


---

# 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://docs.digitalriver.com/digital-river-api/administration/dashboard/developers/api-keys/updating-your-api-version.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.