added api notes for changed api