improvements to reference api