update migration, add api planning doc