finished initial api spec