mobile API: implement and document the end call