clarified API document