add note for api improvements