still unfinished and untested api addition.