This guide describes how to prepare your app to test different versions of the Graph API and to upgrade to the latest version.
The API Upgrade Tool shows the API calls from your app that may be affected by changes in newer versions of the API. You will be able to quickly see which changes you need to make to upgrade from your current version to a newer version.
The API Upgrade Tool displays a customized list of changes that impact an app when upgrading to a specified target version. This allows you to view all relevant changes between the source and target versions.
Step 1. In the Upgrade tool, select your app from the dropdown menu or type in the name of the app.
The dropdown menu only lists up to ten apps. To view more apps than those listed, use the search bar in the dropdown menu.
Step 2. Use the dropdown menus to the right to select the version you would like to Upgrade from and the version you would like to Upgrade to.
The tool displays the number of changes that need to be made to update your app to the selected version. If your app makes API calls that will not be affected by a newer version no data will be returned.
Methods are color coded by the version affecting the call. Hover over the bar chart to see how many changes are in each version. The dates associated with each version are when the changes will be enforced for all apps.
The table shows the type of change (deprecation, new feature or change), which methods are affected, the number of calls made in the last 7 days, and the percentage of API calls affected by that specific change.
Note: Not all changes may affect each API call. Use your best judgment on whether a particular change needs to be handled by your app. Be sure to test your API calls in the newer version to ensure it works properly.
In the App Dashboard Settings > Advanced, scroll to the Upgrade API Version section.
This upgrades all developers and admins of an app to the next available version. This allows you to test changes with a small subset of real users before releasing the new version to the public.
This upgrades all calls made by an app to the next available version. Upgrading early is useful since it preserves the option of going back to the original version in case of unforeseen bugs or issues.