Back to News for Developers

Making it easier to upgrade to Graph API v2.x

December 18, 2014ByDan Xu

At F8 2014 we announced v2.0 of the Graph API, and as a result, we will be deprecating v1.0 on April 30, 2015.

Many apps have already upgraded to API v2.0 or greater (v2.x). These versions include features such as the Tagged Places API, the Social Context API and Page Mentions.

When you prepare to upgrade, your first step is to see how your app behaves when it's updated to v2.x. For some developers, this is as simple as a code change to ensure their API requests declare v2.0 or greater. But we've heard feedback that it'd be valuable to test how an app behaves in v2.x without making any code changes on your side.

To make this easier, we've added the ability to override the applied API version for Test Users of your app. This allows you to login as a test user, and see exactly how your app will behave once you've migrated to v2.x.

To setup a version override for a Test User, visit the Test Users tab in the roles section of your app's dashboard and select “Override the API version in Graph API requests for this test user”:

Next, choose the version that you want applied to all API requests from this test user:

Once you enable this setting, when you make requests with this user's access token, they'll behave as if you're calling the version you selected.

One additional thing to note is that this override control only works for requests made using this specific user's access token. Requests made with other users' tokens, or made with your app token, will behave as normal. If you want to test how your app behaves in its entirety when upgraded to v2.x, you should update your code to call v2.x across all your API requests.

A quick reminder that on April 30, 2015, all API calls which don't specify version v2.0 or greater will automatically behave like v2.0 calls. Please update your code and release an upgraded version before April 30th to avoid people encountering broken experiences when they use your app.

The ability to override the version for test users should make it even easier for you to upgrade your apps to Graph API v2.x.

For more information on how to upgrade to v2.x, please see the upgrade guide.