implementation for new API methods, not yet tested