add initial specs for api methods