enhancements to the api