document basic REST api