API Upgrade Tool

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.

Get Information About Your App

Step 1. Select your app from the dropdown menu or type in the name of the app.

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.

Read the Results

The tool displays the number of changes that need to be made to update your app to the selected version.

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.


I don't see any data when I access the tool. Why not?

There are a few reasons why the tool might not return any results.

  • You are not an admin or developer of an app
  • Your app has not made any, or too few, API calls from the Update from version
  • Your app makes API calls that will not be affected by a newer version

Why don't I see my app in the Search for App dropdown menu?

You must be an admin or developer of the app to view the app in the tool. The selector shows your first ten apps in alphabetical order. To view more apps than those listed, use the search bar in the dropdown menu.

The call volumes look incorrect. Why?

API call logging is sampled and aggregated over the previous week. It is compared with the call volume to estimate how many of your calls could be affected by a given version 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.

Where can I find more info?

  • Click on a method to go to the Graph API Changelog, which will have more specific information about the change.
  • Visit each endpoints reference to learn what change you need to implement for the newer version.