add more detail on the activity API interaction