improved consistency of api options