My company’s website recently went through the Facebook API v1 to v2 upgrade. Besides having to upgrade the OS on all our web servers so we could upgrade PHP, and having to rewrite our implementation code, the only real undocumented issue was dealing app ID format changes.