miscillaneous api improvements