adding doc about the rest api