revise proposed API