added proposed api