public facing APIs