work on improving/clarifying role of api