skeleton for public apis