centralized public api definition