updated doc for API