finishing the api-functionalities, ready for documentation and testing