[api] add note to upgrade.md about removed exception.